Skip to main content
POST
Studio replace section
替换已有歌曲的某一区间。语义同 /suno/v2/generatetask=replace_section,并通过 clip_id 强制同账号选号。
计费同替换策略(非剪辑免费项)。不要写进 /studio/editops。可与 edit / addSection 串联:先 replace 再 crop 收尾。
通过 查询任务状态 轮询至 success。字段对齐 generate 时,也可查阅 Generate Schemareplace_section

参数

示例

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
clip_id
string
必填

原歌曲 clip_id(继续/被替换的源曲)

model
string
必填

模型版本

示例:

"chirp-v55"

range
object
必填

要替换的区间

infill_context_range
object
必填

包含替换区的上下文区间

continued_aligned_prompt
string

歌曲完整歌词(替换后)

prompt
string

替换区歌词

tags
string

风格 tags

negative_tags
string

排除风格

title
string

标题

infill_type
enum<string>

infill 模式

可用选项:
smart,
classic,
fixed
persona
object

响应

201 - application/json
taskId
string
必填

task id. Use this id to query task status.

示例:

"15c257ff-43f7-4678-bd41-202ad6b8488b"