跳转到主要内容
POST
片段重写
也可以用统一任务接口 POST /v1/task/submit 提交:model 填 suno/replace-section,参数放进 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
music_id
string
必填

源曲目:要处理的曲目,填之前生成结果里的 music_id。

infill_start_s
number
必填

重写起点:要重写的片段从第几秒开始。

infill_end_s
number
必填

重写终点:要重写的片段到第几秒结束。

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
prompt
string

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

infill_lyrics
string

新歌词:重写这段要演唱的歌词。

title
string

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

tags
string

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

negative_tags
string

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

variety
enum<string>

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

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

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

model_id
string

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

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