Skip to main content
POST
引用源音轨:基于已有歌曲的操作无需记任何额外 id,只需传 task_id(产出源音轨那次任务的 task_id)+ audio_index(结果 data.result.music[] 里第几首,1-based,默认 1)。

Authorizations

string
必填
所有接口均需要使用Bearer Token进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

Body

string
默认值:"suno"
音频模型。当前传 suno(不传默认 suno)。
string
必填
产出源音轨那次任务的 task_id。缺失或无法解析源时提交期直接返回 400。
integer
默认值:"1"
引用源任务结果 data.result.music[] 中的第几首(1-based;默认 1;一次生成通常 2 首:索引 1 与 2)。
string
替换段歌词。
number
必填
替换起点(秒)。缺失直接返回 400。
number
必填
替换终点(秒)。必须满足 0 ≤ start_s < end_s;源时长已知时不能越界。
string
默认值:"v6"
公共版本:v6 / v6-wild / v6-mini;省略时默认 v6。使用 custom_model_id 时省略本字段。
string
创建模型任务返回的完整 UUID,与 version 互斥。
string
上下文歌词。
string
标题。
string
风格标签。
string
要排除的风格标签。
string
风格变化程度:off / normal / high / extra / max。可省略。
boolean
默认值:"false"
是否启用 Max 模式;启用后按普通售价的 2 倍计费。
string
输出音频格式:mp3 / m4a / wav。本接口不支持目标时长字段。
prompt 是原歌词上下文,infill_lyrics 是替换片段的新歌词。不要发送 custom、instrumental、auto_lyrics 或旧编辑会话字段。
获取结果:本接口为异步任务。提交后拿到 task_id,按 3–5s 间隔轮询 GET /v1/music/tasks/{task_id},直到 status 为 completed 或 failed(音乐生成通常 30–120s;生成中 status 可能为 pending 或 processing,progress 为 0–100 的整数且不保证按固定节点变化)。完成后从 data.result.music[] 取替换后的 audio_url。失败时 data.error.message 给出原因,且预扣额度自动退回。

Response

integer
响应状态码
array
返回数据数组