快速开始

通过本快速开始指南，学习如何获取 API Key 并发起您的第一个 API 请求！

前提条件

一个 Mountsea AI 平台账号（立即注册）
一个 API Key

获取 API Key

注册账号

在 offoff.ai 注册 Mountsea AI 账号。

创建密钥

进入 API Keys 页面，点击 Create New Key。输入密钥名称并点击 Save。

复制密钥

在 API Keys 页面，点击密钥旁的复制图标，将密钥复制到剪贴板。

配置 HTTP 请求

所有 API 请求通过 Bearer Token 认证：

Authorization: Bearer your-api-key

Base URL：https://api.mountsea.ai

快速示例

Gemini 视频
Gemini 图像
Suno
Producer
Chat

第 1 步：创建视频生成任务

curl -X POST "https://api.mountsea.ai/gemini/video/generate" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "一只毛茸茸的橘猫在阳光明媚的草地上奔跑",
    "action": "text2video",
    "model": "veo31_fast",
    "aspectRatio": "16:9"
  }'

响应：

{
  "taskId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

第 2 步：轮询任务结果

curl -X GET "https://api.mountsea.ai/gemini/task/result?taskId=your-task-id" \
  -H "Authorization: Bearer your-api-key"

响应（已完成）：

{
  "taskId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "completed",
  "result": {
    "video_url": "https://..."
  },
  "createdAt": "2026-01-01T12:00:00Z",
  "finishedAt": "2026-01-01T12:02:30Z"
}

每隔数秒轮询任务状态端点，直到 status 变为 completed。可能的状态：pending、ready、assigned、processing、completed、failed、cancelled、timeout。

curl -X POST "https://api.mountsea.ai/gemini/image/generate" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A futuristic city skyline at night, neon lights reflecting on wet streets",
    "action": "generate",
    "model": "nano-banana-fast",
    "aspect_ratio": "16:9"
  }'

响应：

{
  "taskId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

然后轮询 /gemini/task/result?taskId=your-task-id 获取生成的图像。

可用图像模型：nano-banana-fast、nano-banana-pro（支持 1K/2K/4K 分辨率）、nano-banana-2（支持扩展宽高比）、nano-banana-2-lite。

第 1 步：创建音乐生成任务

curl -X POST "https://api.mountsea.ai/suno/v2/generate" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "create",
    "model": "chirp-v55",
    "tags": "Pop, Happy, Upbeat",
    "prompt": "[Verse]\nHello world, here I come\nShining bright like the morning sun\n\n[Chorus]\nLa la la, sing with me\nFeel the rhythm, feel the beat",
    "title": "Hello World"
  }'

响应：

{
  "taskId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

第 2 步：轮询任务状态

curl -X GET "https://api.mountsea.ai/suno/v2/status?taskId=your-task-id" \
  -H "Authorization: Bearer your-api-key"

响应（成功）：

{
  "taskId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "success",
  "data": {
    "...": "clip data with audio URLs"
  },
  "createdAt": "2026-01-01T12:00:00Z",
  "finishAt": "2026-01-01T12:01:30Z"
}

第 1 步：创建音乐生成任务

curl -X POST "https://api.mountsea.ai/producer/audios" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "create_music",
    "model": "Lyria 3 Pro",
    "title": "Summer Vibes",
    "soundPrompt": "emotional pop with gentle piano, warm synths, and a catchy beat",
    "lyrics": "[Verse]\nSunshine on my face today\nEverything is going my way\n\n[Chorus]\nSummer vibes, feeling alive\nDancing through the day and night",
    "makeInstrumental": false
  }'

响应：

{
  "taskId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

第 2 步：轮询任务结果

curl -X GET "https://api.mountsea.ai/producer/tasks?taskId=your-task-id" \
  -H "Authorization: Bearer your-api-key"

响应（已完成）：

{
  "taskId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "completed",
  "result": {
    "...": "audio data with download info"
  },
  "createdAt": "2026-01-01T12:00:00Z",
  "finishedAt": "2026-01-01T12:02:00Z"
}

直接使用 OpenAI SDK——只需修改 base_url：Python

from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="https://api.mountsea.ai/chat"
)

response = client.chat.completions.create(
    model="gpt-5.1",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"}
    ]
)

print(response.choices[0].message.content)

Node.js

import OpenAI from 'openai';

const client = new OpenAI({
    apiKey: 'your-api-key',
    baseURL: 'https://api.mountsea.ai/chat'
});

const response = await client.chat.completions.create({
    model: 'gpt-5.1',
    messages: [
        { role: 'system', content: 'You are a helpful assistant.' },
        { role: 'user', content: 'Hello!' }
    ]
});

console.log(response.choices[0].message.content);

cURL

curl -X POST "https://api.mountsea.ai/chat/v1/chat/completions" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.1",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello!"}
    ]
  }'

使用 Claude Code

export ANTHROPIC_API_KEY="your-api-key"
export ANTHROPIC_BASE_URL="https://api.mountsea.ai/chat/claude"

# 启动 Claude Code
claude

注意：Claude Code 使用 Base URL https://api.mountsea.ai/chat/claude，与其他协议使用的 https://api.mountsea.ai/chat 不同。

🚧 Sora2 — 当前不可用

Sora2 当前在 Mountsea 不可用。 接口 /sora/* 会在网关层被拒绝。视频生成请改用以下替代方案：

异步任务模式

大多数生成服务（Gemini、OpenAI、XAI、Suno、ElevenLabs、Producer）遵循异步任务模式：

1. POST 请求 → 返回 taskId
2. 轮询 GET 端点（携带 taskId）→ 完成后返回 status + result

服务	创建任务	轮询状态
Gemini	`POST /gemini/video/generate`	`GET /gemini/task/result?taskId=xxx`
Gemini 图像	`POST /gemini/image/generate`	`GET /gemini/task/result?taskId=xxx`
🚧 Sora2 (不可用)	~~`POST /sora/video/generate`~~	~~`GET /sora/task/result?taskId=xxx`~~
XAI	`POST /xai/images` 或 `POST /xai/videos`	`GET /xai/tasks?taskId=xxx`
OpenAI	`POST /openai/images`（异步）/ `POST /openai/v1/images/generations`（同步）	`GET /openai/tasks?taskId=xxx`（仅异步）
Suno	`POST /suno/v2/generate`	`GET /suno/v2/status?taskId=xxx`
ElevenLabs	`POST /eleven/music`	`GET /eleven/tasks?taskId=xxx`
Producer	`POST /producer/audios`	`GET /producer/tasks?taskId=xxx`

推荐轮询间隔：每 3-5 秒。生成的文件保留两周——请及时下载，避免丢失访问权限。

下一步

完成首次 API 调用后，探索更多功能：

API 介绍 — 全部服务概览
Gemini 视频与图像 — Veo / Omni 视频与 Nano Banana 图像生成
Gemini 兼容（官方 SDK） — 使用 Google @google/genai SDK 接入 Mountsea
🚧 Sora2 视频 — 当前不可用
XAI (Grok) — Grok 图像与视频生成
OpenAI GPT Image — GPT Image 2 生成与编辑（异步 + 官方 openai SDK 兼容）
Suno 音乐 — 音乐生成、声音角色、自定义模型与音频处理
ElevenLabs 音乐 — AI 音乐，含作曲计划、视频配乐与音轨分离
Producer 音乐 — 基于 Lyria 3 Pro 的 AI 音乐生成
Chat LLM 网关 — 多协议 AI 对话，支持 Claude Code

需要帮助？

如遇问题：

查阅详细的 API 文档了解端点规格
联系支持团队获取帮助
阅读 API 介绍获取完整功能概览

快速入门

Quickstart

快速开始

前提条件

获取 API Key

配置 HTTP 请求

快速示例

第 1 步：创建视频生成任务

第 2 步：轮询任务结果

第 1 步：创建音乐生成任务

第 2 步：轮询任务状态

第 1 步：创建音乐生成任务

第 2 步：轮询任务结果

🚧 Sora2 — 当前不可用

异步任务模式

下一步

需要帮助？

​快速开始

​前提条件

​获取 API Key

​配置 HTTP 请求

​快速示例

​第 1 步：创建视频生成任务

​第 2 步：轮询任务结果

​第 1 步：创建音乐生成任务

​第 2 步：轮询任务状态

​第 1 步：创建音乐生成任务

​第 2 步：轮询任务结果

​🚧 Sora2 — 当前不可用

​异步任务模式

​下一步

​需要帮助？

快速开始

前提条件

获取 API Key

配置 HTTP 请求

快速示例

第 1 步：创建视频生成任务

第 2 步：轮询任务结果

第 1 步：创建音乐生成任务

第 2 步：轮询任务状态

第 1 步：创建音乐生成任务

第 2 步：轮询任务结果

🚧 Sora2 — 当前不可用

异步任务模式

下一步

需要帮助？