Suno Music API
Suno 音乐生成(v5 / v6,用 mv 选版本)。单个模型 suno-v5 通过"传哪些字段"自动路由到十几种模式:灵感/自定义/纯音乐、续写、翻唱、局部编辑、加伴奏、加人声、重制、哼唱成曲、拼接、歌手风格(Persona)、音效。异步:创建返回 taskId → 轮询,一次出 2 个变体。
认证 & 端点
Authorization: Bearer YOUR_API_KEY
POST https://api.apimodels.app/v1/audio/generations # create (all song modes)
GET https://api.apimodels.app/v1/audio/generations?task_id=… # poll status → resultUrls + clipIds
POST https://api.apimodels.app/v1/audio/lyrics # generate lyrics (sync text, free)所有模式都用同一个 model: "suno-v5"。模式由你传的字段自动识别(见下表)。
基础生成
# ── Inspiration (一句描述,模型自动写词谱曲) ──
curl -X POST https://api.apimodels.app/v1/audio/generations \
-H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{ "model": "suno-v5", "description": "an upbeat synthwave track about a night drive", "mv": "chirp-v5" }'
# ── Custom (自带歌词 + 风格 + 标题) ──
curl -X POST https://api.apimodels.app/v1/audio/generations \
-H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{ "model": "suno-v5", "lyrics": "[Verse]\n...", "tags": "pop, female voice", "title": "Night" }'
# Poll → data.resultUrls (2 mp3s) + data.resultJson (JSON string: parse for clipIds/titles/…)
curl "https://api.apimodels.app/v1/audio/generations?task_id=TASK_ID" -H "Authorization: Bearer YOUR_API_KEY"模型版本 (mv)
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| mv 值 | 对应 | 说明 | |
| chirp-v5 | Suno v5 | 默认(不传 mv 时用它) | |
| chirp-v6 | Suno v6 | Suno 2026 年 9 月发布的新一代,价格与 v5 相同 | |
| chirp-v5-5 | Suno v5.5 | v5 小版本迭代 | |
| chirp-v4-5 | Suno v4.5 | 更长单曲、曲风广 | |
| chirp-v4 | Suno v4 | 旧版 |
不传 mv 默认 chirp-v5;要用 v6 就显式传 "mv": "chirp-v6",模型名仍是 suno-v5。Persona 模式内部使用 tau 版本。
全部模式 (按触发字段自动识别)
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| 模式 | 触发字段 | 说明 | |
| 灵感 inspiration | description | 一句描述→自动写词谱曲 | |
| 自定义 custom | lyrics (+ tags / title) | 自带歌词生成 | |
| 纯音乐 instrumental | instrumental: true | 任一模式加此字段=无人声 | |
| 续写 extend | continue_clip_id (+ continue_at) | 从某一秒继续生成 | |
| 翻唱 cover | cover_clip_id (+ lyrics) | 换词/风格重唱 | |
| 局部编辑 infill | infill_clip_id + infill_start_s/end_s | 只替换某时间段 | |
| 加伴奏 underpainting | underpainting_clip_id + start/end_s | 给清唱配伴奏(无需歌词) | |
| 加人声 overpainting | overpainting_clip_id + start/end_s + lyrics | 给纯音乐加演唱 | |
| 重制 remaster | remaster_clip_id (+ variation_category) | 整体重制(必须带歌词/prompt) | |
| 哼唱成曲 chop | chop_sample_clip_id + start/end_s | 哼唱/清唱采样→整曲 | |
| 拼接 concat | concat_clip_id | 把续写过的 clip 合成整曲 | |
| 建歌手风格 persona | root_clip_id + vocal_start_s/end_s | 从人声片段建 persona_id(免费) | |
| 用歌手风格 persona | persona_id + artist_clip_id | 复用已建的声音风格 | |
| 音效 sound | sound (+ sound_type) | 生成一段音效(更便宜) |
编辑类模式(需要 clipId)
续写/翻唱/局部编辑/加伴奏/加人声/重制/哼唱成曲/拼接 都作用在一个已有的 clip 上。clipId 来自任意一次生成成功后的 data.resultJson(是 JSON 字符串,parse 后取 .clipIds[]),也就是 mp3 URL 里的 UUID,不是数字 id。
# 每个"编辑类"模式由它专属的 *_clip_id 字段自动识别;clipId = JSON.parse(data.resultJson).clipIds[]
# 哼唱成曲 — 把一段哼唱/清唱采样变成完整歌曲
curl -X POST https://api.apimodels.app/v1/audio/generations -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{ "model":"suno-v5", "chop_sample_clip_id":"<clipId>", "chop_sample_start_s":0, "chop_sample_end_s":30,
"lyrics":"[Verse 1]\n...", "tags":"pop, female voice", "title":"hum to song" }'
# 局部编辑 — 只替换 [start,end] 秒区间的歌词/旋律
curl -X POST https://api.apimodels.app/v1/audio/generations -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{ "model":"suno-v5", "infill_clip_id":"<clipId>", "infill_start_s":10, "infill_end_s":20, "lyrics":"[Verse]\n新片段", "tags":"pop" }'
# 加人声 — 给纯音乐加演唱人声(overpainting_clip_id + 歌词)
# 加伴奏 — 给清唱配伴奏(underpainting_clip_id,无需歌词)
# 重制 — 整体重制(remaster_clip_id + variation_category: low|medium|high)
# 续写 — continue_clip_id + continue_at;翻唱 — cover_clip_id生成歌词(免费,同步)
一个独立的同步端点,直接返回歌词文本(不是任务),把结果填进 lyrics 字段再去生成即可。对已认证的 API Key 免费。
# 生成歌词(同步返回文本,免费;把结果填进上面的 lyrics 字段即可)
curl -X POST https://api.apimodels.app/v1/audio/lyrics -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{ "prompt": "my love" }'
# → { "code":200, "data": { "lyric": "[Verse 1]\n...", "title": "...", "tags": "..." } }通用参数
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| 字段 | 类型 | 说明 | |
| model | string | 固定 "suno-v5" | |
| mv | string | 模型版本,默认 chirp-v5;chirp-v6 为 Suno v6 | |
| description | string | 灵感模式:一句描述 | |
| lyrics | string | 歌词,支持 [Verse]/[Chorus] 标签,最多 3000 字 | |
| tags | string | 风格,如 "pop, female voice",最多 200 字 | |
| title | string | 标题 | |
| instrumental | boolean | 纯音乐(无人声) | |
| *_clip_id / *_start_s / *_end_s | string / number | 编辑类模式的目标 clip 与时间区间(见上表) | |
| variation_category | string | 重制强度:low / medium / high | |
| callback_url | string | 任务完成回调(可选) |
响应字段
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| 字段 | 类型 | 说明 | |
| code | integer | 200 成功;其它见错误码 | |
| data.taskId | string | 任务 ID,轮询用 | |
| data.state | string | pending / processing / completed / failed | |
| data.resultUrls | string[] | 2 个成品 mp3 的 R2 URL(state=completed 时) | |
| data.resultJson | string (JSON) | JSON 字符串;parse 后含 clipIds[]、titles[]、durations[]、coverUrls[]、tags、lyrics。clipIds 供编辑类模式引用 | |
| data.credits | number | 本次扣费($),仅成功扣 | |
| data.costTime | integer | 耗时(毫秒) | |
| data.failMsg | string | 失败原因(state=failed 时) |
说明
- 异步:POST 返回 taskId,GET ?task_id= 轮询到 state=completed。一次生成 2 个变体。
- 成品 mp3 在 data.resultUrls;clipIds/封面/标题/时长在 data.resultJson(JSON 字符串,需 parse)——见上方响应字段表。
- 结果文件存 R2,保留 30 天后自动删除,请及时下载/转存。
- remaster 上游必须带歌词/prompt(否则报 Need prompt)。
- concat 只接受"续写(extend)"产生的 clip;普通曲会报"并非续写"。
- 建 Persona 免费($0),返回 persona_id + artist_clip_id;之后用 persona 模式复用。
计费
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| 类型 | 价格 | ||
| 歌曲生成(所有模式:灵感/自定义/续写/翻唱/局部编辑/加伴奏/加人声/重制/哼唱成曲/拼接/persona 复用) | $0.26 / 次(出 2 首) | ||
| 音效 sound | $0.05 | ||
| 建歌手风格 persona / 生成歌词 lyrics | 免费 |
仅成功扣费,失败不计费。
常见问题
Suno 音乐 API 多少钱?
歌曲生成 $0.26/次(出 2 首);音效 $0.05;建歌手风格和生成歌词免费。仅成功扣费。
Suno 能把哼唱变成整首歌吗?
能——哼唱成曲模式。先有一个 clip,再传 chop_sample_clip_id + 时间区间 + 歌词,Suno 把采样变成完整编曲。
Suno 支持哪些模式?
灵感、自定义、纯音乐、续写、翻唱、局部编辑、加伴奏、加人声、重制、哼唱成曲、拼接、歌手风格、音效——都用 model suno-v5,模式按字段自动识别。