初始化待编辑视频

POST /v1/videos/multi-elements/init-selection：多模态视频编辑第一步，初始化视频并得到 session_id，同步

POST/v1/videos/multi-elements/init-selection

编辑视频前先初始化，得到 session_id（24 小时有效）。

项	值
模式	同步
计费	目前不单独计费

快速开始

curl https://api.vibelab.me/v1/videos/multi-elements/init-selection \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://example.com/source.mp4"
  }'

响应示例：

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "6a0d571e-d36c-4811-bb2b-698c94b19a8c",
  "data": {
    "status": 0,
    "session_id": "847570360458960960",
    "fps": 30,
    "original_duration": 5000,
    "width": 720,
    "height": 1280,
    "total_frame": 150,
    "normalized_video": "https://example.com/normalized.mp4"
  }
}

请求参数

请求头

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

请求体

参数	类型	必填	默认	说明
`video_url`	string	是	-	视频地址；mp4/mov，时长 2–5 秒或 7–10 秒，边长 720–2160px，24/30/60fps。不支持 `video_id`

响应

字段	类型	说明
`code`	integer	`0` 表示成功，其余见错误
`message`	string	错误信息
`request_id`	string	请求 ID，排查问题时提供
`data.status`	integer	拒识码，非 `0` 为识别失败
`data.session_id`	string	会话 ID，24 小时有效
`data.fps`	number	解析后视频帧率
`data.original_duration`	integer	解析后视频时长
`data.width`、`data.height`	integer	解析后视频宽高
`data.total_frame`	integer	总帧数
`data.normalized_video`	string	初始化后的视频地址

计费

目前不单独计费。

错误

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

HTTP	`code`	触发场景	处理
400	`1201`	`request body must be a JSON object`	请求体传 JSON 对象
400	`1201`	`video_url is required and must be a string`	传 `video_url`
400	`1201`	`video_id is not supported, use video_url`	改传 `video_url`

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

注意事项

会话归属 → 只能操作自己初始化得到的会话。
替换或删除元素 → 初始化后还要用选区接口标记元素。
会话有效期 → session_id 24 小时有效。

初始化待编辑视频

本页内容