Add Instrumental
Add accompaniment onto existing vocals. The source must come from suno-upload.
Submitted fields are validated even if unused by the current mode. gpt_description is required when custom=false.
version:v6/v6-wild/v6-mini, defaultv6. Mutually exclusive withcustom_model_id.- Unsupported:
auto_lyrics,persona_id,instrumental, target duration. max_moderequires custom mode and bills at 2×. Useweirdnesson new requests.
Authorization
BearerAuth
使用 MAPI Bearer Token 认证。格式：Authorization: Bearer sk-xxxxxx。
In: header
Request Body
application/json
固定填写 suno-add-instrumental。
suno-upload 上传任务的 ID，必填。普通生成任务不能使用；缺失或无法解析源时提交期直接返回 400。
源任务结果 music[] 中的第几首（1-based，默认 1；一次上传通常 2 首：索引 1 与 2）。
11 <= value公共版本：v6 / v6-wild / v6-mini。省略默认 v6。使用 custom_model_id 时省略。
"v6""v6" | "v6-wild" | "v6-mini"创建模型任务返回的完整 UUID，与 version 互斥。
true 为自定义模式，prompt 作歌词；false 为灵感模式，用 gpt_description。省略时按内容推断：有 prompt → true；无 prompt 但有 gpt_description → false；否则有 tags 或 title → true。
歌词。仅 custom=true 时生效，灵感模式下被忽略。
灵感提示词。custom=false 时必填，缺失提交期直接返回 400、不扣费。custom=true 时被忽略。
标题。仅 custom=true 时生效。
风格标签。仅 custom=true 时生效。
要排除的风格标签。仅 custom=true 时生效。
风格权重，范围 0.00–1.00。越界提交期直接返回 400。仅 custom=true 时生效。
0 <= value <= 1创意权重，范围 0.00–1.00。兼容旧名 weirdness_constraint；新请求请使用 weirdness。
0 <= value <= 1音频权重，范围 0.00–1.00。仅 custom=true 时生效。
0 <= value <= 1人声性别：Male / Female。两种模式都生效。
"Male" | "Female"风格变化程度：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-add-instrumental", "task_id": "task_01ABC", "audio_index": 1, "version": "v6", "tags": "lo-fi" }'{
"code": 200,
"message": "success",
"data": [
{
"status": "submitted",
"task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
}
]
}{
"code": "invalid_request",
"message": "task_id is required",
"data": null
}Last updated on