Suno Music API

由 Suno 提供音乐

通过 Suno v6 创建歌曲和歌词,也可训练自定义模型、翻唱、分离音轨、编辑、下载、分析和查询异步结果。

更新于:
输入提示词文本
模型3款可用
返回方式异步结果链接
价格起价 0.2每次付费操作
生成示例

从创作要求到音乐

模型能力

Suno Music API 能做什么

作曲和写歌词

用灵感模式或自定义模式生成完整歌曲,也可单独生成歌词。

定制模型与改编

使用 6 至 24 首曲目训练可复用的模型,再对已有音乐进行续写、翻唱或改编。

获取音频与分轨

查询结果并下载 MP3、M4A 或 WAV,可单独分离人声或拆分全部音轨。

计费

按操作计费,单位为 quota

按模型、操作和输出设置扣除 quota。

Suno 操作价格官方定价
操作价格计费单位
音乐生成 · 语音 · 续写 · 翻唱 · 上传并翻唱 · 上传并续写 · 添加人声 · 添加伴奏 · 添加音轨6 quota / 次
音频重制 · 混搭 · 参考音频创作 · 采样 · MIDI · 替换片段6 quota / 次
音轨分离12 quota / 次
拆分全部音轨30 quota / 次
裁剪 · 删除片段 · 淡入 · 淡出 · 歌词1 quota / 次
调整速度3 quota / 次
音效1.2 quota / 次
上传音频0.5 quota / 次
创建音色2 quota / 次
创建模型60 quota / 次
下载文件 · WAV(已弃用)0.2 quota/ 次请求
拼接 · Persona · 对齐歌词 · 视频 · 扩写标签 · BPM免费/ 次请求
max_mode=true基础 quota 的两倍/ 次生成
API 请求

Suno Music API 操作和请求字段

使用 TTAPI 密钥,按下方字段向接口发送请求。

生成音乐POST
/suno/v1/music

通过创作描述或自定义歌词生成音乐。

查看接口文档
生成语音POST
/suno/v1/speech

合成朗读语音,可选背景音乐。

查看接口文档
上传并翻唱POST
/suno/v1/upload-cover

在请求中传入可公开访问的音频链接,即可生成翻唱。

查看接口文档
上传并续写POST
/suno/v1/upload-extend

在请求中传入可公开访问的音频链接,并指定从哪里开始续写。

查看接口文档
上传音频POST
/suno/v1/upload

为可用续写和编辑流程上传音频。

查看接口文档
分离音轨POST
/suno/v1/stems

分离人声、伴奏或所有可用分轨。

查看接口文档
拆分全部音轨POST
/suno/v1/stems-all

将曲目拆分为完整的多轨素材。

查看接口文档
添加人声POST
/suno/v1/add-vocals

在现有编曲中添加生成的人声轨。

查看接口文档
添加伴奏POST
/suno/v1/add-instrumental

围绕现有音频编排伴奏。

查看接口文档
添加音轨POST
/suno/v1/add-stem

为现有曲目叠加一条生成的音轨。

查看接口文档
替换片段POST
/suno/v1/replace-section

重新生成歌曲中指定的一段。

查看接口文档
参考音频创作POST
/suno/v1/inspo

从 1 至 4 个参考音频 URL 生成曲目。

查看接口文档
从采样生成歌曲POST
/suno/v1/sample

用一段采样素材创作完整歌曲。

查看接口文档
移除片段POST
/suno/v1/remove-section

删除曲目中指定时间范围的片段。

查看接口文档
调整速度POST
/suno/v1/adjust-speed

改变播放速度,可选择保留原音高。

查看接口文档
拼接曲目POST
/suno/v1/concat

把完成的歌曲片段接成一条音轨。

查看接口文档
导出 MIDIPOST
/suno/v1/gen-midi

将生成音乐导出为 MIDI,便于继续编辑。

查看接口文档
获取对齐歌词POST
/suno/v1/alignedLyrics

获取按词对齐时间的歌词。

查看接口文档
生成音乐视频POST
/suno/v1/generateVideo

为已完成的歌曲生成音乐视频。

查看接口文档
下载文件POST
/suno/v1/download

准备 MP3、M4A 或 WAV 文件,缓存返回的链接可避免重复收费。

查看接口文档
创建音色POST
/suno/v1/create-voice

从已完成的歌曲创建可复用的 Suno 音色。

查看接口文档
创建自定义模型POST
/suno/v1/create-model

使用 6 至 24 个公开参考音轨训练私有模型。

查看接口文档
创建 PersonaPOST
/suno/v1/persona

从现有歌曲生成可复用的 Suno Persona。

查看接口文档
扩写风格标签POST
/suno/v1/upsample-tags

把简短风格要求扩写为更详细的音乐标签。

查看接口文档
导出 WAV(已弃用)POST
/suno/v1/wav

旧版 WAV 导出接口,请迁移到「下载文件」。

查看接口文档
查询结果(已弃用)GET
/suno/v1/fetch

旧版任务查询接口,请改用「查询结果 V2」。

查看接口文档
POSThttps://api.ttapi.io/suno/v1/music

请求头

TT-API-KEYstring必填

填写 TTAPI API 密钥。

Content-Typestring必填

使用 application/json。

请求体

customboolean必填

设为 true 时使用自定义歌词模式。

instrumentalboolean必填

设为 true 时生成无人声的音轨。

mvenum必填

可选 chirp-v6、chirp-v6-wild、chirp-v6-mini 或 chirp-custom:{model_id}。旧模型名会映射到 chirp-v6。

gpt_description_promptstring按条件填写

灵感模式(custom=false)必填的创作要求,最多 3,000 字符。

promptstring按条件填写

自定义模式的歌词,instrumental=false 时必填,最多 5,000 字符。

titlestring选填

自定义模式的曲名,最多 80 字符。

tagsstring选填

自定义模式的曲风、氛围、乐器和人声标签,最多 1,000 字符。

negative_tagsstring选填

要避开的风格或特征。

style_weightnumber选填

自定义模式的风格权重,范围 0 至 1。

weirdness_constraintnumber选填

自定义模式的创意权重,范围 0 至 1。

audio_weightnumber选填

自定义模式的源音频权重,范围 0 至 1。

durationinteger选填

自定义模式的输出时长,范围 10 至 360 秒。

auto_lyricsboolean选填

自定义模式下是否自动重新诠释输入歌词。

vocal_genderenum选填

可选人声性别,填写 Male 或 Female。

persona_idstring选填

自定义模式的 Suno Persona,不能与 mv=chirp-custom:{model_id} 同时使用。

audio_formatenum选填

音频输出可选 mp3、m4a 或 wav。

varietyenum选填

风格变化程度可选 off、normal、high、extra 或 max。

max_modeboolean选填

自定义模式的一致性增强,默认 false,启用后消耗两倍 quota。

hookUrlstring选填

任务完成时调用的回调 URL。

isStorageboolean选填

已弃用。控制是否保存到 TTAPI CDN,默认为 true。

查看 TTAPI 接入文档
接入示例

发送请求并获取结果

复制当前模型的请求地址、鉴权请求头和请求体。

curl --request POST \
  --url https://api.ttapi.io/suno/v1/music \
  --header "TT-API-KEY: $TTAPI_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"custom":false,"instrumental":false,"mv":"chirp-v6","gpt_description_prompt":"slow cinematic electronic soul, 75 BPM, deep sub-bass, warm Rhodes piano, soft brushes, atmospheric pads, intimate low male vocal","audio_format":"mp3","variety":"normal","hookUrl":"https://example.com/webhooks/suno"}'