预览已选区视频

POST /v1/videos/multi-elements/preview-selection：预览已选区视频，同步

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

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

快速开始

curl https://api.vibelab.me/v1/videos/multi-elements/preview-selection \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "session_id": "847570360458960960"
  }'

响应示例：

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "6a0d571e-d36c-4811-bb2b-698c94b19a8c",
  "data": {
    "status": 0,
    "session_id": "847570360458960960",
    "res": {
      "video": "https://example.com/masked.mp4",
      "video_cover": "https://example.com/cover.png",
      "tracking_output": "https://example.com/tracking.json"
    }
  }
}

请求参数

请求头

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

请求体

参数	类型	必填	默认	说明
`session_id`	string	是	-	初始化返回的会话

响应

字段	类型	说明
`code`	integer	`0` 表示成功，其余见错误
`message`	string	错误信息
`request_id`	string	请求 ID，排查问题时提供
`data.status`	integer	拒识码，非 `0` 为识别失败
`data.session_id`	string	会话 ID
`data.res.video`	string	含选区掩码的视频
`data.res.video_cover`	string	该视频的封面
`data.res.tracking_output`	string	每一帧的掩码结果

计费

目前不单独计费。

错误

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

HTTP	`code`	触发场景	处理
400	`1201`	`session_id is required and must be a string`	传初始化返回的 `session_id`
400	`1201`	`session_id not found`	会话不存在或不属于当前账号，重新初始化/识别后再用

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

注意事项

会话归属 → 只能操作自己初始化得到的会话。

预览已选区视频

本页内容