APIMODELSAPIMODELS
API 文档

apimodels.app

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-v5Suno v5默认(不传 mv 时用它)
chirp-v6Suno v6Suno 2026 年 9 月发布的新一代,价格与 v5 相同
chirp-v5-5Suno v5.5v5 小版本迭代
chirp-v4-5Suno v4.5更长单曲、曲风广
chirp-v4Suno v4旧版

不传 mv 默认 chirp-v5;要用 v6 就显式传 "mv": "chirp-v6",模型名仍是 suno-v5。Persona 模式内部使用 tau 版本。

全部模式 (按触发字段自动识别)

字段必填类型说明
模式触发字段说明
灵感 inspirationdescription一句描述→自动写词谱曲
自定义 customlyrics (+ tags / title)自带歌词生成
纯音乐 instrumentalinstrumental: true任一模式加此字段=无人声
续写 extendcontinue_clip_id (+ continue_at)从某一秒继续生成
翻唱 covercover_clip_id (+ lyrics)换词/风格重唱
局部编辑 infillinfill_clip_id + infill_start_s/end_s只替换某时间段
加伴奏 underpaintingunderpainting_clip_id + start/end_s给清唱配伴奏(无需歌词)
加人声 overpaintingoverpainting_clip_id + start/end_s + lyrics给纯音乐加演唱
重制 remasterremaster_clip_id (+ variation_category)整体重制(必须带歌词/prompt)
哼唱成曲 chopchop_sample_clip_id + start/end_s哼唱/清唱采样→整曲
拼接 concatconcat_clip_id把续写过的 clip 合成整曲
建歌手风格 personaroot_clip_id + vocal_start_s/end_s从人声片段建 persona_id(免费)
用歌手风格 personapersona_id + artist_clip_id复用已建的声音风格
音效 soundsound (+ 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": "..." } }

通用参数

字段必填类型说明
字段类型说明
modelstring固定 "suno-v5"
mvstring模型版本,默认 chirp-v5;chirp-v6 为 Suno v6
descriptionstring灵感模式:一句描述
lyricsstring歌词,支持 [Verse]/[Chorus] 标签,最多 3000 字
tagsstring风格,如 "pop, female voice",最多 200 字
titlestring标题
instrumentalboolean纯音乐(无人声)
*_clip_id / *_start_s / *_end_sstring / number编辑类模式的目标 clip 与时间区间(见上表)
variation_categorystring重制强度:low / medium / high
callback_urlstring任务完成回调(可选)

响应字段

字段必填类型说明
字段类型说明
codeinteger200 成功;其它见错误码
data.taskIdstring任务 ID,轮询用
data.statestringpending / processing / completed / failed
data.resultUrlsstring[]2 个成品 mp3 的 R2 URL(state=completed 时)
data.resultJsonstring (JSON)JSON 字符串;parse 后含 clipIds[]、titles[]、durations[]、coverUrls[]、tags、lyrics。clipIds 供编辑类模式引用
data.creditsnumber本次扣费($),仅成功扣
data.costTimeinteger耗时(毫秒)
data.failMsgstring失败原因(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免费

仅成功扣费,失败不计费。

相关:其它音频 API(ElevenLabs / Kling)

常见问题

Suno 音乐 API 多少钱?

歌曲生成 $0.26/次(出 2 首);音效 $0.05;建歌手风格和生成歌词免费。仅成功扣费。

Suno 能把哼唱变成整首歌吗?

能——哼唱成曲模式。先有一个 clip,再传 chop_sample_clip_id + 时间区间 + 歌词,Suno 把采样变成完整编曲。

Suno 支持哪些模式?

灵感、自定义、纯音乐、续写、翻唱、局部编辑、加伴奏、加人声、重制、哼唱成曲、拼接、歌手风格、音效——都用 model suno-v5,模式按字段自动识别。