跳转到主要内容
POST
音乐生成
也可以用统一任务接口 POST /v1/task/submit 提交:model 填 suno/music,参数放进 input。两种写法效果与计费完全一样。
任务成功后,data.musics 里是产出的曲目,一次 2 条。部分成功时按实际成功的条数计费。
string
必填
曲目 ID。续写、翻唱、分轨、导出等后续操作都填它。
string
标题。
string
风格标签。
string
歌词,纯伴奏没有这个字段。
string
音频地址,可直接下载。
string
封面图地址。
string
大尺寸封面图地址。
string
视频地址,没有视频时不返回。
number
时长,单位秒。

授权

Authorization
string
header
必填

在请求头 Authorization: Bearer YOUR_API_KEY 里带上 API Key。

请求体

application/json
mv
enum<string>
默认值:chirp-v6

模型版本:三个版本价格相同,按需要的风格选择。可选值:chirp-v6 v6(默认,均衡);chirp-v6-wild v6 Wild(风格更奔放);chirp-v6-mini v6 Mini(更快)。

可用选项:
chirp-v6,
chirp-v6-wild,
chirp-v6-mini
custom
boolean
默认值:false

自定义模式:关闭时你只需用一句话描述想要什么;开启时由你提供完整歌词。

instrumental
boolean
默认值:false

纯伴奏:开启后只出伴奏,不演唱歌词。

gpt_description_prompt
string

灵感描述:一句话描述想要的歌,例如「轻柔的 lo-fi 钢琴,雨夜」。关闭自定义模式时必填,最长 3000 字。

prompt
string

歌词:完整歌词,最长 5000 字。可以用 [Verse]、[Chorus] 这类标记划分段落。

title
string

标题:曲目标题,最长 80 字。

tags
string

风格标签:想要的曲风,例如「lo-fi 钢琴, 舒缓, 雨声」,最长 1000 字。

negative_tags
string

排除风格:不希望出现的曲风,用来避开某些方向。

style_weight
number

风格贴合度:0 到 1。越高越贴近你写的风格标签,越低留给模型的发挥空间越大。

weirdness_constraint
number

创意发散度:0 到 1。越高越出人意料,越低越接近常规写法。

audio_weight
number

参考音频权重:0 到 1。调节参考音频对成品的影响程度。

duration
integer

时长:成品时长,单位秒,10 到 360 之间。

auto_lyrics
boolean
默认值:false

自动润色歌词:开启后会把你写的歌词改写得更适合演唱,仅自定义模式有效。

vocal_gender
enum<string>

人声性别:指定演唱者的嗓音性别。可选值:Male 男声;Female 女声。

可用选项:
Male,
Female
persona_id
string

指定音色:用之前创建好的音色来演唱,填音色 ID。仅自定义模式有效。

model_id
string

自建模型:用自建模型来生成,填创建模型结果里的 model_id。不能与 persona_id 同时使用。

variety
enum<string>

风格发散度:控制成品与指定风格的偏离程度,从完全贴合到大胆发挥。可选值:off 完全贴合;normal 均衡;high 较为多变;extra 大胆发挥;max 最大发散。

可用选项:
off,
normal,
high,
extra,
max
max_mode
boolean
默认值:false

最高质量模式:投入更多算力让整首歌前后更连贯。仅自定义模式有效,开启后价格翻倍。

audio_format
enum<string>

输出格式:成品音频的格式,不填默认 mp3。可选值:mp3 MP3(通用);m4a M4A;wav WAV(无损)。

可用选项:
mp3,
m4a,
wav
notify_hook
string<uri>

推送地址:任务结束后,把和查询结果相同的内容 POST 到这个地址(公网可以访问的 http / https 地址)。不传就自己查询。

响应

OK

code
enum<string>
必填
可用选项:
success
data
object
必填
message
string