创建多模态编辑任务

POST /v1/videos/multi-elements：对视频增加、替换或删除元素，异步

POST/v1/videos/multi-elements

对视频增加、替换或删除元素。

项	值
模式	异步（提交 → 轮询 `GET /v1/videos/multi-elements/{id}`，见查询多模态编辑任务）
计费	按输出视频实际时长（秒）结算，提交时按请求的 `duration` 预冻结

快速开始

curl https://api.vibelab.me/v1/videos/multi-elements \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "session_id": "847570360458960960",
    "edit_mode": "removal",
    "prompt": "删除<<<video_1>>>中的【小鸡】",
    "mode": "std",
    "duration": "5"
  }'

响应示例：

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "6a0d571e-d36c-4811-bb2b-698c94b19a8c",
  "data": {
    "task_id": "893605946402811985",
    "task_status": "submitted",
    "task_info": {
      "external_task_id": "your-id"
    },
    "created_at": 1722769557708,
    "updated_at": 1722769557708
  }
}

请求参数

请求头

参数	类型	必填	默认	说明
`Authorization`	string	是	-	`Bearer $LOOPTOKEN_API_KEY`
`Content-Type`	string	是	-	`application/json`

请求体

参数	类型	必填	默认	说明
`session_id`	string	是	-	初始化返回的会话，只能使用自己初始化得到的会话
`edit_mode`	string	是	-	`addition`（增加元素，`image_list` 1–2 张）、`swap`（替换元素，1 张）、`removal`（删除元素，不传）
`image_list`	array	视模式	-	`[{ "image": "URL 或不带前缀的 Base64" }]`；jpg/jpeg/png，不超过 10MB，宽高不小于 300px，宽高比 1:2.5 到 2.5:1
`prompt`	string	是	-	用 `<<<video_1>>>`、`<<<image_1>>>` 指代素材，不超过 2500 个字符
`negative_prompt`	string	否	-	不超过 2500 个字符
`mode`	string	否	`std`	`std` 或 `pro`
`duration`	string	否	`"5"`	`"5"` 或 `"10"`；输入视频 2–5 秒对应 5，7–10 秒对应 10
`watermark_info.enabled`	boolean	否	`false`	是否同时生成含水印结果
`callback_url`	string	否	-	任务状态变化时的 HTTPS 回调地址，见概览
`external_task_id`	string	否	-	自定义任务 ID，同一账号下不可重复

响应

字段	类型	说明
`code`	integer	`0` 表示成功，其余见错误
`message`	string	错误信息
`request_id`	string	请求 ID，排查问题时提供
`data.task_id`	string	任务 ID
`data.task_status`	string	`submitted`、`processing`、`succeed`、`failed`
`data.task_info.external_task_id`	string	创建时传入的自定义任务 ID
`data.created_at`、`data.updated_at`	integer	Unix 毫秒时间戳

计费

按输出视频实际时长（秒）结算。提交时按请求的 duration 预冻结额度，任务结束后多退少补；失败全额退回。

错误

本页参数校验返回 400 / 1201，message 原文如下：

HTTP	`code`	触发场景	处理
400	`1201`	`session_id is required and must be a string`	传初始化返回的 `session_id`
400	`1201`	`session_id not found`	会话不存在或不属于当前账号，重新初始化/识别后再用
400	`1201`	`edit_mode must be addition, swap or removal`	传三者之一
400	`1201`	`image_list must be an array`	`image_list` 传数组
400	`1201`	`image_list must contain 1-2 images for addition`（`swap` 为 `1-1`，`removal` 为 `0-0`）	按模式调整 `image_list` 数量
400	`1201`	`image_list[].image is required`	每项补 `image`
400	`1201`	`prompt is required and must be a string`	传非空 `prompt`
400	`1201`	`prompt must not exceed 2500 characters` / `negative_prompt must not exceed 2500 characters`	缩短文本
400	`1201`	`mode must be std or pro`	传 `std` 或 `pro`
400	`1201`	`duration must be 5 or 10`	传 `"5"` 或 `"10"`

通用错误（鉴权、余额、并发、回调地址、上游错误）见 Kling 错误。

注意事项

前置步骤 → 先初始化视频，替换或删除元素时再标记选区。
继续编辑 → 任务成功后结果视频里的 session_id 也归你所有，可以继续编辑。
与官方的差别 → 响应不返回 final_unit_deduction、final_balance_deduction；callback_url 由 LoopToken 投递，external_task_id 在你的账号范围内去重。

创建多模态编辑任务

本页内容