Studio add section (phase 1)
Studio
Studio Add Section
Phase 1 — generate candidate fills at an insert point
POST
Studio add section (phase 1)
Insert a new section at
Part of the Studio Editing group.
After polling succeeds, pick a candidate clip id and proceed to Add Section Commit.
insert_at_s via infill generation. Returns 2 candidates. Poll Get Task Status until success, then call Add Section Commit.
Billed like music creation (
create). Task result includes candidate clips plus Studio project context needed for phase 2.Parameters
| Field | Type | Required | Description |
|---|---|---|---|
clip_id | string | Yes | Source clip |
insert_at_s | number | Yes | Insert position in the original song (seconds) |
duration_s | number | No | New section length, 4–32 seconds (default 16) |
lyrics | string | No | Lyrics for the new section; omit for instrumental |
tags | string | No | Style tags; inherits original style if omitted |
negative_tags | string | No | Styles to exclude |
model | string | No | Model version (default chirp-v55 / chirp-fenix) |
title | string | No | Candidate title |
Example
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
原歌曲 clip_id
在原曲的这个秒数处插入新段落
Required range:
x >= 0新段落时长,范围 4~32,默认 16
Required range:
4 <= x <= 32新段落歌词;不传则为纯音乐
风格;不传则继承原曲风格
排除风格
模型版本,默认 chirp-v55 / chirp-fenix
Example:
"chirp-v55"
候选标题
Response
201 - application/json
task id. Use this id to query task status.
Example:
"15c257ff-43f7-4678-bd41-202ad6b8488b"