Skip to main content
POST
/
kling
/
v1
/
videos
/
multi-elements
/
add-selection
增加视频选区
curl --request POST \
  --url https://api.deerapi.com/kling/v1/videos/multi-elements/add-selection \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "session_id": "784914037360041984",
  "frame_index": 1,
  "points": [
    {
      "x": 0,
      "y": 1
    }
  ]
}
'
{}
当前页不是“上传一张遮罩图”,而是在关键帧上点选主体,让系统自己扩成选区轨迹。

标记时怎么做更稳

1

先挑最有代表性的帧

优先选主体最清晰、无遮挡、轮廓最完整的帧来打第一批点。
2

把 points 当成百分比坐标

xy 的取值都在 0-1 之间。0,0 代表左上角,1,1 代表右下角。
3

主体动作变化大时再补帧

一次只标记一帧,但整个 session 最多可以补多个关键帧。动作变化明显时再追加新的 frame_index
4

打完先预览

预览已选区视频 看跟踪范围是不是稳定,再决定是否继续增加、删减或清空选区。

points 怎么写

[
	{ "x": 0.42, "y": 0.31 },
	{ "x": 0.45, "y": 0.54 }
]

最容易出错的地方

  • frame_index 选在主体模糊或被遮挡的帧上。
  • 坐标写成像素值,而不是 0-1 之间的百分比。
  • 主体动作已经明显变形,却还只依赖第一帧的点选结果。

下一步常见动作

预览已选区视频

检查跟踪区域有没有偏到背景或漏掉主体。

删减视频选区

选区过大、框错对象时,用这一页做删减修正。

清除视频选区

当前 session 的选区完全不对时,直接清空重来更快。

Authorizations

Authorization
string
header
required

Bearer token authentication. Use your DeerAPI key.

Body

application/json
session_id
string
default:example
required

会话ID,会基于视频初始化任务生成,不会随编辑选区行为而改变

frame_index
integer
default:1
required

帧号

最多支持添加10个标记帧,即最多基于10帧标记视频选区 1次仅支持标记1帧

points
object
required

点选坐标,用x、y表示 取值范围:[0,1],用百分比表示;[0,1]代表画面左上角 支持同时增加多个标记点,某一帧最多可标记10个点

Response

200 - application/json

成功

The response is of type object.