Skip to main content
POST
Studio batch edit
Run crop / remove / duplicate / split / reverse / fade / speed ops in order, then export once. Poll Get Task Status until success.
Usually free (0 credits; see conf_task_policy). Do not put addSection or replace into ops — use dedicated endpoints.
Part of Studio Editing. Seconds for each op are relative to the timeline after previous ops.

Parameters

Supported ops[].op

Tips for writing ops

  • Prefer crop / removeSection before fade* / setSpeed.
  • After a length-changing op, re-estimate seconds — do not reuse original song timestamps blindly.
  • fadeOut.start_s must not exceed the current remaining duration.
  • Prefer one batch export over crop→export→fade→export chains (lock contention).

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

ops
object[]
required

操作列表,至少 1 项,建议 ≤ 20

Required array length: 1 - 20 elements
title
string

最终导出标题

beat
object

Optional metronome export; omit for legacy behavior

Response

201 - application/json
taskId
string
required

task id. Use this id to query task status.

Example:

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