Skip to main content
POST
Studio replace section
Replace a range of an existing song. Same semantics as /suno/v2/generate with task=replace_section, with same-account routing via clip_id.
Billed like replace (not a free trim). Do not put this into /studio/edit ops. You may chain after edit / addSection using the new clip.
Poll Get Task Status until success. For field details that mirror generate, also see Generate Schema for replace_section.

Parameters

Example

Authorizations

Authorization
string
header
required

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

Body

application/json
clip_id
string
required

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

model
string
required

模型版本

Example:

"chirp-v55"

range
object
required

要替换的区间

infill_context_range
object
required

包含替换区的上下文区间

continued_aligned_prompt
string

歌曲完整歌词(替换后)

prompt
string

替换区歌词

tags
string

风格 tags

negative_tags
string

排除风格

title
string

标题

infill_type
enum<string>

infill 模式

Available options:
smart,
classic,
fixed
persona
object

Response

201 - application/json
taskId
string
required

task id. Use this id to query task status.

Example:

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