Skip to main content
POST
Studio add section (phase 1)
insert_at_s 通过 infill 插入新段落,返回 2 个候选 + 供阶段二使用的 Studio 上下文。轮询 查询任务状态success 后,用选定的 candidate_clip_id 调用 提交插入段落不需要阶段一 taskId)。
计费同创建音乐。通过 clip_id 选号。插入点请离片头/片尾足够远(约两侧各 >0.5s);贴边续写请用 generate extend,不要用 addSection。
属于 Studio 编辑

参数

成功 data(示意)

产品 UI:展示两候选 → 用户点选某个 clips[].id → 阶段二只需传 candidate_clip_id

实战建议

示例

授权

Authorization
string
header
必填

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

请求体

application/json
clip_id
string
必填

原歌曲 clip_id

insert_at_s
number
必填

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

必填范围: x >= 0
duration_s
number
默认值:16

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

必填范围: 4 <= x <= 32
section_beats
number
默认值:32

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

必填范围: 8 <= x <= 256
lyrics
string

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

tags
string

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

negative_tags
string

排除风格

model
string

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

示例:

"chirp-v55"

title
string

候选标题

响应

201 - application/json
taskId
string
必填

task id. Use this id to query task status.

示例:

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