# 多模态视频编辑 （增加视频选区）

**方法**: `POST`
**路径**: `/kling/v1/videos/multi-elements/add-selection`

本文档不实时更新，完整版请查看官方文档：<https://app.klingai.com/cn/dev/document-api/apiReference/model/multimodalToVideo>

## 请求参数

### Header 参数

```text
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}
```

### Body 参数 application/json

```text
model_name
string
可选
kling-v1、kling-v1-5、kling-v1-6
prompt
string
必需
正向文本提示，必须，不能超过500个字符
<= 500 字符
negative_prompt
string
可选
负向文本提示，可选，不能超过200个字符
<= 200 字符
cfg_scale
number
可选
生成视频的自由度，可选，值越大，相关性越强，取值范围：[0,1]
>= 0
<= 1
mode
enum<string>
可选
生成视频的模式，可选，枚举值：std（高性能）或 pro（高表现）
枚举值:
std（高性能）
pro（高表现）
camera_control
object
可选
控制摄像机运动的协议，可选，未指定则智能匹配
type
string
可选
config
object
可选
包含六个字段，用于指定摄像机的运动或变化
aspect_ratio
enum<string>
可选
生成视频的画面纵横比，可选，枚举值：16:9, 9:16, 1:1
枚举值:
16:9
9:16
1:1
duration
enum<string>
可选
生成视频时长，单位秒，可选，枚举值：5，10
枚举值:
5
10
callback_url
string
可选
本次任务结果回调通知地址，可选
示例
{
"session_id"
:
"string"
,
"frame_index"
:
"int"
,
"points"
:
"object[]"
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/kling/v1/videos/multi-elements/add-selection' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "session_id": "string",
    "frame_index": "int",
    "points":"object[]"
}'
```

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
code
integer
必需
错误码；具体定义错误码
message
string
错误信息
必需
request_id
string
必需
请求ID，系统生成，用于跟踪请求、排查问题
data
object
必需
task_id
string
必需
任务ID，系统生成
task_status
enum<string>
必需
任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
枚举值:
submitted（已提交
processing（处理中）
succeed（成功）
failed（失败）
created_at
integer
必需
任务创建时间，Unix时间戳、单位ms
updated_at
integer
必需
任务更新时间，Unix时间戳、单位ms
```

#### 示例

```json
{
    "code": 0,
    "message": "string",
    "request_id": "string",
    "data": {
        "task_id": "string",
        "task_status": "string",
        "created_at": 0,
        "updated_at": 0
    }
}
```