音频(Audio)Suno
完整歌曲合成、拼接
-
将已有歌曲任务中的片段合成为完整歌曲,适用于续写结果的拼接。
-
本模型无版本维度,不要传
version;即使传入也会被 MAPI 丢弃,不影响计费。 -
源任务必须是
suno-extend续写产生的分段结果;普通一次性生成的完整歌曲不能用于拼接,上游会返回参数错误。 -
使用续写任务的
task_id和audio_index引用待拼接分段,无需记录额外音频 ID。 -
完成后从任务结果
music[]中读取完整歌曲的audio_url。 -
通常需要 30–120 秒,建议每 3–5 秒查询一次公共任务接口。
-
提交接口:统一通过
POST /v1/music/generations提交,使用model: "suno-concat"选择此能力。 -
任务查询:提交返回
task_id,通过GET /v1/music/generations/{task_id}获取任务状态和结果。
Authorization
BearerAuth
AuthorizationBearer <token>
使用 MAPI Bearer Token 认证。格式:Authorization: Bearer sk-xxxxxx。
In: header
Request Body
application/json
model*string
固定填写 suno-concat。
task_id*string
必须是 suno-extend 续写任务的 ID。
audio_index?integer
Default
1Range
1 <= valueaudio_format?string
输出音频格式。
Value in
"mp3" | "m4a" | "wav"Response Body
application/json
application/json
curl -X POST "https://loading/v1/music/generations" \ -H "Content-Type: application/json" \ -d '{ "model": "suno-concat", "task_id": "task_extendXXXXXXXX", "audio_index": 1, "audio_format": "mp3" }'{
"code": 200,
"message": "success",
"data": [
{
"status": "submitted",
"task_id": "task_aehCmxJ5YUNOIQGgkhvxaco4T9P2h3Dw"
}
]
}{
"code": "invalid_request",
"message": "task_id is required",
"data": null
}最后更新于