Suno

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

Suno 走 https://api.mountsea.ai 的 REST。多数接口异步：POST 返回 taskId，再轮询 GET /suno/v2/status。

核心能力

音乐生成

创建、延长、翻唱、混搭、分轨、音效 — 15 种任务共用 /generate。

Persona

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

Inspiration

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

Studio

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

定制模型

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

歌词与音效

原创歌词、混搭歌词，或 task=sound 文生音效。

导出与分析

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

批量上传 Session

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

模型

模型	说明
`chirp-v55`	最新版 — 推荐所有任务
`chirp-v50`	上一代高质量
`chirp-45+` / `chirp-v45` / `chirp-v45-lite`	质量与速度均衡
`chirp-v40` / `chirp-v35`	旧版
`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": "..." }。片段 Persona（/persona）和创建播放列表是同步的。

轮询到成功

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

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\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	统一生成 — 15 种任务
`/suno/v2/generate/schema`	GET	每种任务的字段与示例
`/suno/v2/status`	GET	用 `taskId` 轮询

Persona

端点	方法	说明
`/suno/v2/persona`	POST	片段 Persona — 已脱敏，同步
`/suno/v2/getVoxStem`	POST	提取人声，供片段 Persona
`/suno/v2/voices`	POST	Clone Voice — 收费 Voice Persona（产物同 Init+Complete）
`/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/concat`	POST	拼接
`/suno/v2/remaster`	POST	重制
`/suno/v2/adjustSpeed`	POST	变速
`/suno/v2/upsampleTags`	POST	增强风格标签
`/suno/v2/mp4` / `wav` / `mdi`	POST	导出
`/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`	新歌
`extend` / `upload_extend`	延长 clip 或上传文件
`cover` / `upload_cover`	翻唱 clip 或上传文件
`use_styles_lyrics`	保留风格，换歌词
`replace_section`	替换区间
`add_instrumental` / `add_vocals`	在时间范围内加伴奏 / 人声
`gen_stem_two` / `gen_stem_all`	分轨
`mashup` / `sample`	混搭或采样
`inspiration`	基于真实 `playlist_id`
`sound`	音效

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

​Suno

​核心能力

音乐生成

Persona

Inspiration

Studio

定制模型

歌词与音效

导出与分析

批量上传 Session

​模型

​选一条路径

先出第一首歌

克隆人声

改已有成曲

不确定传什么字段

​调用方式

​端点

​核心

​Persona

​Inspiration

​图片、视频与片段编辑

​Studio

​歌词、处理、导出

​上传与定制模型

​生成任务类型

Suno

核心能力

模型

选一条路径

调用方式

端点

核心

Persona

Inspiration

图片、视频与片段编辑

Studio

歌词、处理、导出

上传与定制模型

生成任务类型