Skip to content
EN

多模态视频编辑(初始化待编辑视频)

方法: POST路径: /kling/v1/videos/multi-elements/init-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
可选
本次任务结果回调通知地址,可选
示例
{
"video_id"
:
"string"
,
"video_url"
:
"string"
,
}

请求示例代码

Shell

bash
curl --location --request POST '/kling/v1/videos/multi-elements/init-selection' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "video_id": "string",
    "video_url": "string",
}'

返回响应

🟢 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
    }
}