段落替换

替换歌曲的某一段（infill）。用产出源音轨那次任务的 task_id + audio_index（1-based，默认 1）引用源。

start_s、end_s 必填，须满足 0 ≤ start_s < end_s；源时长已知时不能越界。

prompt 是原歌词上下文，infill_lyrics 是替换片段的新歌词。
version：v6 / v6-wild / v6-mini，省略默认 v6。使用 custom_model_id 时省略。custom_model_id 与 version 互斥。
不要发送 custom、instrumental、auto_lyrics 或旧编辑会话字段。本接口不支持目标时长。
max_mode=true 按普通售价的 2 倍计费。
提交接口：POST /v1/music/generations，model: "suno-replace-section"。
任务查询：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-replace-section。

task_id*string

产出源音轨那次任务的 ID，必填。缺失或无法解析源时提交期直接返回 400。

audio_index?integer

源任务结果 music[] 中的第几首（1-based，默认 1；一次生成通常 2 首：索引 1 与 2）。

Default1

Range1 <= value

infill_lyrics?string

替换片段的新歌词。

start_s*number

替换起点（秒），必填。缺失直接返回 400。须满足 0 ≤ start_s < end_s。

Range0 <= value

end_s*number

替换终点（秒），必填。必须满足 0 ≤ start_s < end_s；源时长已知时不能越界。缺失直接返回 400。

version?string

公共版本：v6 / v6-wild / v6-mini。省略默认 v6。使用 custom_model_id 时省略。

Default"v6"

Value in"v6" | "v6-wild" | "v6-mini"

custom_model_id?string

创建模型任务返回的完整 UUID，与 version 互斥。

prompt?string

原歌词上下文。与 infill_lyrics（替换片段的新歌词）含义不同。

title?string

标题。

tags?string

风格标签。

negative_tags?string

要排除的风格标签。

variety?string

风格变化程度：off / normal / high / extra / max。可省略。

Value in"off" | "normal" | "high" | "extra" | "max"

max_mode?boolean

是否启用 Max 模式；启用后按普通售价的 2 倍计费。

Defaultfalse

audio_format?string

输出音频格式：mp3 / m4a / wav。本接口不支持目标时长字段。

Value in"mp3" | "m4a" | "wav"

Response Body

application/json

curl -X POST "https://loading/v1/music/generations" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-replace-section",
    "task_id": "task_01ABC",
    "audio_index": 1,
    "start_s": 30,
    "end_s": 45,
    "infill_lyrics": "新的一段歌词"
  }'

curl -X POST "https://loading/v1/music/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "suno-replace-section",    "task_id": "task_01ABC",    "audio_index": 1,    "start_s": 30,    "end_s": 45,    "infill_lyrics": "新的一段歌词"  }'

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

{
  "code": "invalid_request",
  "message": "start_s is required",
  "data": null
}

Authorization

Request Body

Response Body

200application/json

400application/json

application/json

application/json