快速开始

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

前提条件

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

获取 API Key

注册账号

在 shanhaiapi.com 注册 Mountsea AI 账号。

创建密钥

进入 API 密钥管理 页面，点击 创建新密钥，输入密钥名称并保存。

复制密钥

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

配置 HTTP 请求

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

Authorization: Bearer your-api-key

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

快速示例

🎬 使用 Gemini (Veo 3.1) 生成视频

第 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 步：轮询任务结果

使用返回的 taskId 查询生成状态：

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。

🖼️ 使用 Gemini (Nano Banana) 生成图片

curl -X POST "https://api.mountsea.ai/gemini/image/generate" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "未来城市夜景，霓虹灯倒映在湿润的街道上",
    "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（支持更多比例）。

🎥 使用 Sora2 生成视频

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

curl -X POST "https://api.mountsea.ai/sora/video/generate" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "一只猫在道路上奔跑，电影级光影",
    "model": "sora-2",
    "orientation": "landscape",
    "duration": 10,
    "removeWatermark": true
  }'

响应：

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

第 2 步：轮询任务结果

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

响应（成功）：

{
  "taskId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "success",
  "result": {
    "video_url": "https://...",
    "editId": "xxxxxxxxxx"
  },
  "createdAt": "2026-01-01T12:00:00Z",
  "finishedAt": "2026-01-01T12:03:00Z"
}

🎵 使用 Suno 生成音乐

第 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]\n你好世界，我来了\n像清晨的阳光一样闪耀\n\n[Chorus]\n啦啦啦，和我一起唱\n感受节奏，感受律动",
    "title": "你好世界"
  }'

响应：

{
  "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": {
    "...": "包含音频 URL 的片段数据"
  },
  "createdAt": "2026-01-01T12:00:00Z",
  "finishAt": "2026-01-01T12:01:30Z"
}

🎧 使用 Producer 生成音乐

第 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": "夏日心情",
    "soundPrompt": "emotional pop with gentle piano, warm synths, and a catchy beat",
    "lyrics": "[Verse]\n阳光洒在脸上\n一切都在朝好的方向走\n\n[Chorus]\n夏日心情，充满活力\n昼夜起舞不停歇",
    "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": {
    "...": "包含下载信息的音频数据"
  },
  "createdAt": "2026-01-01T12:00:00Z",
  "finishedAt": "2026-01-01T12:02:00Z"
}

💬 使用 LLM 对话（OpenAI 兼容）

直接使用 OpenAI SDK，只需更改 base_url：

Python
Node.js
cURL

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": "你是一个有帮助的助手。"},
        {"role": "user", "content": "你好！"}
    ]
)

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

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: '你是一个有帮助的助手。' },
        { role: 'user', content: '你好！' }
    ]
});

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

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": "你是一个有帮助的助手。"},
      {"role": "user", "content": "你好！"}
    ]
  }'

💬 使用 Claude Code

配置环境变量即可使用 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 不同。

异步任务模式

大部分生成服务（Gemini、Sora2、XAI、Suno、Producer）遵循异步任务模式：

1. POST 请求 → 返回 taskId
2. 用 taskId 轮询 GET 端点 → 完成后返回状态 + 结果

服务	创建任务	轮询状态
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`
Suno	`POST /suno/v2/generate`	`GET /suno/v2/status?taskId=xxx`
Producer	`POST /producer/audios`	`GET /producer/tasks?taskId=xxx`

建议轮询间隔：每 3-5 秒。生成的文件保存两周 —— 请及时下载以免失效。

下一步

完成第一个 API 请求后，探索更多功能：

API 介绍 — 所有服务的完整概览
Gemini 视频与图片 — Veo 2/3/3.1 视频和 Nano Banana 图片生成
Sora2 视频 — OpenAI Sora 文生视频
XAI (Grok) — Grok 图片与视频生成
Suno 音乐 — 音乐生成、声音角色、自定义模型和音频处理
Producer 音乐 — Lyria 3 Pro AI 音乐生成
Chat LLM 网关 — 多协议 AI 对话，支持 Claude Code

需要帮助？

遇到问题？

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

快速入门

Quickstart

快速开始

前提条件

获取 API Key

配置 HTTP 请求

快速示例

🎬 使用 Gemini (Veo 3.1) 生成视频

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

第 2 步：轮询任务结果

🖼️ 使用 Gemini (Nano Banana) 生成图片

🎥 使用 Sora2 生成视频

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

第 2 步：轮询任务结果

🎵 使用 Suno 生成音乐

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

第 2 步：轮询任务状态

🎧 使用 Producer 生成音乐

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

第 2 步：轮询任务结果

💬 使用 LLM 对话（OpenAI 兼容）

💬 使用 Claude Code

异步任务模式

下一步

需要帮助？

快速入门

​快速开始

​前提条件

​获取 API Key

​配置 HTTP 请求

​快速示例

​🎬 使用 Gemini (Veo 3.1) 生成视频

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

​第 2 步：轮询任务结果

​🖼️ 使用 Gemini (Nano Banana) 生成图片

​🎥 使用 Sora2 生成视频

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

​第 2 步：轮询任务结果

​🎵 使用 Suno 生成音乐

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

​第 2 步：轮询任务状态

​🎧 使用 Producer 生成音乐

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

​第 2 步：轮询任务结果

​💬 使用 LLM 对话（OpenAI 兼容）

​💬 使用 Claude Code

​异步任务模式

​下一步

​需要帮助？

快速开始

前提条件

获取 API Key

配置 HTTP 请求

快速示例

🎬 使用 Gemini (Veo 3.1) 生成视频

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

第 2 步：轮询任务结果

🖼️ 使用 Gemini (Nano Banana) 生成图片

🎥 使用 Sora2 生成视频

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

第 2 步：轮询任务结果

🎵 使用 Suno 生成音乐

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

第 2 步：轮询任务状态

🎧 使用 Producer 生成音乐

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

第 2 步：轮询任务结果

💬 使用 LLM 对话（OpenAI 兼容）

💬 使用 Claude Code

异步任务模式

下一步

需要帮助？