Suno

生成、克隆人声、时间线精修与导出 — 一套 API 覆盖完整 Suno 流程。

Suno 走 https://api.mountsea.ai 的 REST。两种调用方式，不要混：

异步 — POST 返回 { "taskId": "..." }。轮询 GET /suno/v2/status?taskId=...，直到 success / failed / timeout。
同步 — 当次 HTTP 响应就是结果。没有 taskId。 不要轮询 /status。

核心能力

音乐生成

创建、延长、翻唱、混搭、分轨、加轨、简单替换、音效 — 17 种任务。字段和示例：生成任务。

Persona

片段 Persona（已脱敏），或 Voice Persona — Clone Voice（/voices，收费）或 Init + Complete（免费）。

Inspiration

先建真实播放列表，再用 task=inspiration 生成。

Studio

Song Editor — 在同一 clip 上裁剪、淡化、替换、加段。

定制模型

用 6+ 条音频训练，生成时使用 chirp-custom:<uuid>。

歌词与音效

原创歌词、混搭歌词、同步歌词填充、朗读（create + is_speech），或 task=sound 音效。

导出与分析

MP4 / WAV / M4A / MDI、歌词时间线与节拍。

批量上传 Session

多个文件落到同一 Suno 账号 — Inspiration 和部分 Persona 必需。

模型

模型	说明
`chirp-v6`	最新 v6 Pro — 推荐
`chirp-v6-mini`	v6 免费档
`chirp-v6-wild`	v6 wild
`chirp-v55` 及更早	仍可传入，一律自动转到 v6 Pro
`chirp-custom:<uuid>`	自训练模型 — 见定制模型

选一条路径

先出第一首歌

对 task=create 查 Schema，再 /generate 并轮询状态。

克隆人声

片段 Persona vs Voice Persona。Clone Voice（/voices，收费）与 Init + Complete（免费）是同一种 Voice Persona。

改已有成曲

免费时间线操作优先 Studio 批量编辑；加段 / 替换才计费。

不确定传什么字段

GET /suno/v2/generate/schema?task=xxx 返回必填字段和可复制示例。

调用方式

先查 Schema

生成任务用 Generate Schema。其他接口看下面的表。

调用接口

异步 → { "taskId": "..." }。同步 → 当次响应就是业务 JSON（不用轮询）。

只有拿到 taskId 才轮询

获取任务状态 — GET /suno/v2/status?taskId=xxx。

异步 vs 同步

类型	响应	下一步
异步	`{ "taskId" }`	轮询 `/status`
同步	结果体	结束。不要轮询 `/status`（服务端可能写内部审计任务，但不对外返回 taskId）

异步（轮询 /status）：/generate、/lyrics、/mashupLyrics、/concat、/remaster、/upload、/mp4、/mdi、/adjustSpeed、/voices、/voicePersona/init + /complete、/image/generate、/video/standalone/generate、/audio/crop /fade /reverse、全部 /studio/*、session 的 item 上传、customModel/upload + /create。同步（当次出结果）：/generate/schema、/checkAccountOffline、/persona、/getVoxStem、/playlist/create + /addClips、/wav、/m4a、/timing、/downbeats、/upsampleTags、/lyricsInfill、/audio/upload/session（返回 sessionId）、/customModel/prepare（返回 sessionId）。

导出是混着的：/mp4 和 /mdi 是异步；/wav 和 /m4a 是同步，当次响应里就有 download_url。

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-v6",
    "tags": "Pop, Happy, Upbeat",
    "prompt": "[Verse]\nHello world, here I come\n\n[Chorus]\nLa la la...",
    "title": "Summer Vibes"
  }'

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

端点

核心

端点	方法	说明
`/suno/v2/generate`	POST	统一生成 — 17 种任务
`/suno/v2/generate/schema`	GET	每种任务的字段与示例
`/suno/v2/status`	GET	用 `taskId` 轮询
`/suno/v2/checkAccountOffline`	GET	该任务的账号是否离线（同步）

Persona

端点	方法	说明
`/suno/v2/persona`	POST	片段 Persona — 已脱敏，同步
`/suno/v2/getVoxStem`	POST	提取人声，供片段 Persona
`/suno/v2/voices`	POST	Clone Voice — 收费一步 Voice Persona（异步）；`/generate` 只需 `persona_id` + `is_voice: true`
`/suno/v2/voicePersona/init`	POST	免费两步 — 取短语（`awaiting`）
`/suno/v2/voicePersona/complete`	POST	免费两步 — 提交朗读录音

绑定规则和 is_voice 见 Persona 总览。

Inspiration

端点	方法	说明
`/suno/v2/playlist/create`	POST	创建播放列表并绑账号（同步）
`/suno/v2/playlist/addClips`	POST	追加 clip（同步）

图片、视频与片段编辑

端点	方法	说明
`/suno/v2/image/generate`	POST	独立图片（异步）
`/suno/v2/video/standalone/generate`	POST	独立视频（异步）
`/suno/v2/audio/crop`	POST	裁剪（异步，免费）
`/suno/v2/audio/fade`	POST	淡化（异步，免费）
`/suno/v2/audio/reverse`	POST	反转（异步）

Studio

端点	方法	说明
`/suno/v2/studio/edit`	POST	批量时间线（通常免费）
`/suno/v2/studio/crop` … `/setSpeed`	POST	单项免费操作
`/suno/v2/studio/addSection`	POST	阶段一 — 候选（计费）
`/suno/v2/studio/addSectionCommit`	POST	阶段二 — 提交（通常免费）
`/suno/v2/studio/replace`	POST	替换区间（计费）

歌词、处理、导出

端点	方法	说明
`/suno/v2/lyrics`	POST	生成歌词
`/suno/v2/mashupLyrics`	POST	两首歌歌词混搭
`/suno/v2/lyricsInfill`	POST	填充一段歌词（同步）
`/suno/v2/concat`	POST	拼接
`/suno/v2/remaster`	POST	重制
`/suno/v2/adjustSpeed`	POST	变速
`/suno/v2/upsampleTags`	POST	增强风格标签（同步）
`/suno/v2/mp4` / `mdi`	POST	导出（异步 — 轮询 `/status`）
`/suno/v2/wav` / `m4a`	POST	导出（同步 — 响应里就是 `download_url`）
`/suno/v2/timing` / `downbeats`	POST	分析（同步）

上传与定制模型

端点	方法	说明
`/suno/v2/upload`	POST	单文件（账号可能不同）
`/suno/v2/audio/upload/session`	POST	同账号 Session（同步）
`/suno/v2/audio/upload/session/item`	POST	Session 内传单个文件
`/suno/v2/customModel/prepare`	POST	创建训练会话
`/suno/v2/customModel/upload`	POST	上传训练音频（至少 6）
`/suno/v2/customModel/create`	POST	提交训练（100 积分）

生成任务类型

任务	说明
`create`	新歌 — Custom（写词）或 Simple（想法 / `audio_refs` / 钉住歌词 / `image_urls` / `video_url`）
`extend` / `upload_extend`	延长 clip 或上传文件
`cover` / `upload_cover`	翻唱 clip 或上传文件
`use_styles_lyrics`	保留风格，换歌词
`replace_section`	替换区间（自己算上下文）
`replace_simple`	简单替换（`clip_id` + `range`；计费为 `replace_section`）
`add_instrumental` / `add_vocals`	在时间范围内加伴奏 / 人声
`gen_stem_two` / `gen_stem_all`	分轨
`add_stems`	给 clip 加轨（`stem_control_tags`，默认 `"add "`）
`mashup` / `sample`	混搭或采样
`inspiration`	基于真实 `playlist_id`
`sound`	音效 — 必填 `description`；可选 `type` / `key` / `bpm`

每种任务字段不同。请用 Generate Schema。

​Suno

​核心能力

音乐生成

Persona

Inspiration

Studio

定制模型

歌词与音效

导出与分析

批量上传 Session

​模型

​选一条路径

先出第一首歌

克隆人声

改已有成曲

不确定传什么字段

​调用方式

​异步 vs 同步

​端点

​核心

​Persona

​Inspiration

​图片、视频与片段编辑

​Studio

​歌词、处理、导出

​上传与定制模型

​生成任务类型

Suno

核心能力

模型

选一条路径

调用方式

异步 vs 同步

端点

核心

Persona

Inspiration

图片、视频与片段编辑

Studio

歌词、处理、导出

上传与定制模型

生成任务类型