Skip to main content
POST
/
kling
/
v1
/
videos
/
multi-elements
创建任务
curl --request POST \
  --url https://api.deerapi.com/kling/v1/videos/multi-elements \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "session_id": "example",
  "edit_mode": "example",
  "prompt": "Hello"
}
'
{}
当前页是整套多元素编辑 workflow 的最后一步。没有 session_id 时，不要直接调它。

​
先把这组接口当成一个四步流程

1

初始化待编辑视频

先在 初始化待编辑视频 里拿到 session_id。
2

标记选区

再用 增加视频选区 在关键帧点选你真正要编辑的主体。
3

预览跟踪结果

用 预览已选区视频 确认选区有没有跑偏。
4

提交最终编辑任务

回到当前页，传 session_id、edit_mode 和 prompt。

​
当前页最少要传什么

  • session_id
  • edit_mode
  • prompt
edit_mode 的具体枚举和可用能力更新较快。第一次接入时，先以当前 OpenAPI 页面和你实测可用值为准，不要按旧文章或第三方截图硬写。

​
什么时候不要急着提交最终任务

  • 预览里主体跟踪明显跑偏。
  • 关键动作只覆盖到了少数帧。
  • 你的需求其实是“重新框选”，而不是“直接开始编辑”。

​
相关页面

初始化待编辑视频

先拿 session_id，这是后面所有步骤的起点。

增加视频选区

在关键帧点选要编辑的主体。

预览已选区视频

先看跟踪范围，再决定是否真正提交编辑任务。

Kling 官方多元素编辑文档

需要核对上游最新说明时再看这一页。

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your DeerAPI key.

Body

application/json
​
session_id
string
default:example
required
​
edit_mode
string
default:example
required
​
prompt
string
default:Hello
required

Response

200 - application/json

成功

The response is of type object.