动作控制
⚠️ 测试中
▼
Authorization
在 Header 添加参数 Authorization，其值为 Bearer 之后拼接 Token
示例：
Authorization: Bearer ********************
请求参数
Header 参数
Content-Type
string
可选
示例: application/json
Authorization
string
可选
示例: Bearer {{YOUR_API_KEY}}
Body 参数 application/json
model_name
string
可选
默认 kling-v2-6 kling-v3
prompt
string
可选
文本提示词，可包含正向描述和负向描述 可通过提示词为画面增加元素、实现运镜效果等，详见可灵「动作控制」使用指南 不能超过2500个字符
image_url
string
必需
参考图像，生成视频中的人物、背景等元素均已参考图为准 视频内容需满足以下要求： 人物可以是写实风格人物或与自然人身材比例相似的卡通风格人物，避免遮挡；写实风格人物效果更好 图像中人物面积需超过图像面积的5% 包含支持传入图片Base64编码或图片URL（确保可访问） 图片格式支持.jpg / .jpeg / .png 图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比介于1:2.5 ~ 2.5:1之间
video_url
string
必需
视频内容需满足以下要求： 有且只能有1个写实风格，全身或上半身、包含头部的人物，避免遮挡 人物肢体动作与表情动作清晰且不包括空翻、倒立等复杂动作 动作视频一镜到底，人物始终出现在画面某种，避免切镜、运镜等 视频文件支持.mp4/.mov，文件大小不超过100MB，仅支持长宽的边长均位于340px~3850px之间，上述校验不通过会返回错误码等信息 视频时长下限不短于3秒，时长上限与人物朝向参考（character_orientation）有关： 当人物朝向与视频中人物一致时，视频时长最长可达30秒； 当人物朝向与图片中人物一致时，视频时长最长可达10秒； 系统会校验视频内容，如有问题会返回错误码等信息
element_list
array [object]
可选
主体参考列表
element_id
string
可选
引用主体时，生成的视频暂时只能参考视频中的人物朝向 暂时仅支持引入1个主体
keep_original_sound
string
可选
可选择是否保留视频原声 枚举值：yes，no 其中yes：保留视频原声 其中no：不保留视频原声
character_orientation
string
必需
生成视频中人物的朝向，可选择与图片一致或与视频一致 枚举值：image，video，其中： 其中image：与图片中人物朝向一致；此时参考视频时长不得超过10秒； 其中video：与视频中人物朝向一致；此时参考视频时长不得超过30秒；
mode
string
必需
生成视频的模式 枚举值：std，pro 其中std：标准模式（标准），基础模式，性价比高 其中pro：专家模式（高品质），高表现模式，生成视频质量更佳
callback_url
string
可选
external_task_id
string
可选
watermark_info
array [object]
可选
是否同时生成含水印的结果
示例
{
"model_name": "kling-v3",
"image_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-3.ng.png",
"prompt": "女孩穿着灰色宽松T恤和牛仔短裤",
"video_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dance.mp4",
"keep_original_sound": "yes",
"character_orientation": "image",
"mode": "pro"
}请求示例代码
curl --location --request POST 'https://api.quickrouter.ai/kling/v1/videos/motion-control' --header 'Authorization: Bearer YOUR_API_KEY' --header 'Content-Type: application/json' --data-raw '{
"model_name": "kling-v3",
"image_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-3.ng.png",
"prompt": "女孩穿着灰色宽松T恤和牛仔短裤",
"video_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dance.mp4",
"keep_original_sound": "yes",
"character_orientation": "image",
"mode": "pro"
}'var myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer YOUR_API_KEY");
myHeaders.append("Content-Type", "application/json");
var raw = JSON.stringify({
"model_name": "kling-v3",
"image_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-3.ng.png",
"prompt": "女孩穿着灰色宽松T恤和牛仔短裤",
"video_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dance.mp4",
"keep_original_sound": "yes",
"character_orientation": "image",
"mode": "pro"
});
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("https://api.quickrouter.ai/kling/v1/videos/motion-control", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));import http.client
import json
conn = http.client.HTTPSConnection("api.quickrouter.ai")
payload = json.dumps({
"model_name": "kling-v3",
"image_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-3.ng.png",
"prompt": "女孩穿着灰色宽松T恤和牛仔短裤",
"video_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dance.mp4",
"keep_original_sound": "yes",
"character_orientation": "image",
"mode": "pro"
})
headers = {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
conn.request("POST", "/kling/v1/videos/motion-control", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))返回响应
响应参数 application/json
object
string
可选
示例
{}