Skip to main content
POST
/
kling
/
v1
/
videos
/
multi-elements
/
init-selection
curl --request POST \
  --url https://api.deerapi.com/kling/v1/videos/multi-elements/init-selection \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "video_id": "784912347344945152",
  "task_id": "784912347277836288"
}
'
{}
这一步的唯一目标是拿到 session_id。后面所有选区接口都围绕它工作。

​
两种输入方式怎么选

输入来源适合什么情况必填组合
Kling 历史视频你要编辑的是 Kling 近 30 天内生成的视频video_id + task_id
外部视频 URL你要编辑的是自己已有的公开视频素材video_url
video_id 和 video_url 二选一。只有在传 video_id 时，task_id 才是必填。

​
素材限制先看这里

  • 仅支持 MP4 和 MOV。
  • 时长需在 2-5.5 秒或 7-10.5 秒区间内。
  • 宽高需在 720px 到 2160px 之间。
  • 仅支持 24、30 或 60fps。

​
推荐的初始化顺序

1

先选素材来源

如果素材本来就来自 Kling，优先走 video_id + task_id。如果素材是你自己的公开视频，再走 video_url。
2

提交初始化请求

当前页不会直接开始编辑，它只是把这段视频放进多元素编辑 session。
3

保存 session_id

返回后立即保存 session_id。这就是后面 增加视频选区、预览已选区视频 和 创建任务 的主键。

​
下一步该去哪

增加视频选区

开始在关键帧点选你真正要跟踪和编辑的主体。

创建任务

只有在 session 和选区都准备好以后，才应该回到最终创建页。

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your DeerAPI key.

Body

application/json
​
video_id
string
default:example
required

kling生成的video id；和video_url二选一，不能同时传； 视频ID从历史作品中选择待编辑的视频，仅支持仅30天时间生成的视频作品；仅支持时长≥2秒且≤5.5秒，或≥7秒且≤10.5秒的视频 与video_url参数相关，不能同时为空，也不能同时有值

​
task_id
string
default:example
required

传video id 时必传该视频生成时的task id

​
video_url
string
default:example
required

获取视频的URL，上传时传视频下载链接，编辑选区时传接口返回的视频URL

仅支持MP4和MOV格式 仅支持时长≥2秒且≤5.5秒，或≥7秒且≤10.5秒的视频 视频宽高尺寸需介于720px（含）和2160px（含）之间 仅支持上传24、30或60fps的视频 与video_url参数相关，不能同时为空，也不能同时有值

Response

200 - application/json

成功

The response is of type object.