上传音频并延伸
-
直接用公网音频 URL 延伸歌曲,无需先调用
suno-upload。 -
必填
audio_url(公网 HTTP(S) 直链,建议不超过 8 分钟)和continue_at(≥1 秒且严格小于源时长)。不要传本地路径或blob:URL。 -
固定自定义模式:不要发送
custom、instrumental或gpt_description。 -
version仅支持v6/v6-wild/v6-mini,省略默认v6。使用custom_model_id时省略version;custom_model_id与persona_id互斥。 -
duration_s目标时长 10–360 秒,实际成品时长以任务结果为准。max_mode=true按普通售价的 2 倍计费。 -
提交接口:统一通过
POST /v1/music/generations提交,使用model: "suno-upload-extend"选择此能力。 -
任务查询:提交返回
task_id,通过GET /v1/music/generations/{task_id}获取任务状态和结果。
Authorization
BearerAuth
使用 MAPI Bearer Token 认证。格式:Authorization: Bearer sk-xxxxxx。
In: header
Request Body
application/json
固定填写 suno-upload-extend。
公网可访问的 HTTP(S) 音频直链,建议不超过 8 分钟。本地路径与 blob: URL 不可用。
uri延伸起点,必须大于等于 1 秒,并严格小于源音频实际时长。
1 <= value公共版本:v6 / v6-wild / v6-mini。省略默认 v6。使用 custom_model_id 时省略。
"v6""v6" | "v6-wild" | "v6-mini"创建模型任务返回的完整 UUID。与 version、persona_id 互斥。
延伸段歌词,不超过 5000 个字符;省略时按纯音乐延伸语义使用。
length <= 5000风格描述,不超过 1000 个字符。
length <= 1000标题,不超过 80 个字符。
length <= 80不希望出现的风格。
风格权重,范围 0–1。
0 <= value <= 1创意度权重,范围 0–1。
0 <= value <= 1音频权重,范围 0–1。
0 <= value <= 1是否对输入歌词进行二次创作。
人声性别:Male / Female。
"Male" | "Female"Persona ID,与 custom_model_id 互斥。
目标生成时长,范围 10–360 秒。实际成品时长以任务结果为准。
10 <= value <= 360风格变化程度:off / normal / high / extra / max。
"off" | "normal" | "high" | "extra" | "max"是否启用 Max 模式;启用后按普通售价的 2 倍计费。
false输出格式:mp3 / m4a / wav。
"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-upload-extend", "version": "v6-mini", "audio_url": "https://example.com/reference.wav", "continue_at": 30, "prompt": "[Outro]\n下一段旅途,我们一起走", "tags": "acoustic pop", "duration_s": 60, "max_mode": true, "audio_format": "mp3" }'{
"code": 200,
"message": "success",
"data": [
{
"status": "submitted",
"task_id": "task_01M24YMN4EV04M84R5QYM77R1E"
}
]
}{
"code": "invalid_request",
"message": "audio_url is required",
"data": null
}最后更新于