Skip to main content
POST
Studio add section (phase 1)
Insert a generated section at insert_at_s via infill. Returns 2 candidates + Studio context for commit. Poll Get Task Status until success, then call Add Section Commit with the chosen candidate_clip_id (no phase-1 taskId required).
Billed like music creation. Account is resolved from clip_id. Keep insert_at_s away from song edges (~>0.5s); for ends use generate extend, not addSection.
Part of Studio Editing.

Parameters

Success data (shape)

UI: play both candidates → user picks a clips[].id → phase 2 with candidate_clip_id only.

Practical tips

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

insert_at_s
number
required

在原曲的这个秒数处插入新段落

Required range: x >= 0
duration_s
number
default:16

新段落生成窗口秒数,范围 4~32,默认 16(不等于最终插入时长)

Required range: 4 <= x <= 32
section_beats
number
default:32

Studio 时间线预留空档(beat)。默认 32(官网 Create Section);与 duration_s 解耦,可按需加大以装下更长生成内容

Required range: 8 <= x <= 256
lyrics
string

新段落歌词;不传则为纯音乐

tags
string

风格;不传则继承原曲风格

negative_tags
string

排除风格

model
string

模型版本,默认 chirp-v55 / chirp-fenix

Example:

"chirp-v55"

title
string

候选标题

Response

201 - application/json
taskId
string
required

task id. Use this id to query task status.

Example:

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