增加视频选区

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

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

快速开始

curl https://api.vibelab.me/v1/videos/multi-elements/add-selection \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "session_id": "847570360458960960",
    "frame_index": 0,
    "points": [
      {
        "x": 0.7738,
        "y": 0.2971
      }
    ]
  }'

响应示例：

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "6a0d571e-d36c-4811-bb2b-698c94b19a8c",
  "data": {
    "status": 0,
    "session_id": "847570360458960960",
    "res": {
      "frame_index": 0,
      "rle_mask_list": [
        {
          "object_id": 0,
          "rle_mask": {
            "size": [
              720,
              1280
            ],
            "counts": "…"
          },
          "png_mask": {
            "size": [
              720,
              1280
            ],
            "base64": "…"
          }
        }
      ]
    }
  }
}

请求参数

请求头

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

请求体

参数	类型	必填	默认	说明
`session_id`	string	是	-	初始化返回的会话
`frame_index`	integer	是	-	帧号；最多支持 10 个标记帧，一次标记 1 帧
`points`	array	是	-	点选坐标 `[{ "x": 0.77, "y": 0.29 }]`，取值 0–1 的画面比例，左上角为原点；一帧最多 10 个点

响应

字段	类型	说明
`code`	integer	`0` 表示成功，其余见错误
`message`	string	错误信息
`request_id`	string	请求 ID，排查问题时提供
`data.status`	integer	拒识码，非 `0` 为识别失败
`data.session_id`	string	会话 ID
`data.res.frame_index`	integer	帧号
`data.res.rle_mask_list[].object_id`	integer	选区对象编号
`data.res.rle_mask_list[].rle_mask`	object	RLE 编码的掩码，`size` 为 [高, 宽]，`counts` 为编码串
`data.res.rle_mask_list[].png_mask`	object	PNG 掩码，`base64` 为图片数据

计费

目前不单独计费。

错误

本页参数校验返回 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 错误。选区、帧号、点坐标等字段由上游校验，上游的参数类错误（1200–1203、1300、1301）按其 HTTP、code、message 原样返回。

注意事项

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

增加视频选区

本页内容