Motion control
curl --request POST \
--url https://models.kapon.cloud/kling/v1/videos/motion-control \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"callback_url": "<string>",
"character_orientation": "<string>",
"element_list": [
{
"element_id": 123
}
],
"external_task_id": "<string>",
"image_url": "<string>",
"keep_original_sound": "<string>",
"mode": "<string>",
"model_name": "<string>",
"prompt": "<string>",
"video_url": "<string>",
"watermark_info": {
"enabled": true
}
}
'import requests
url = "https://models.kapon.cloud/kling/v1/videos/motion-control"
payload = {
"callback_url": "<string>",
"character_orientation": "<string>",
"element_list": [{ "element_id": 123 }],
"external_task_id": "<string>",
"image_url": "<string>",
"keep_original_sound": "<string>",
"mode": "<string>",
"model_name": "<string>",
"prompt": "<string>",
"video_url": "<string>",
"watermark_info": { "enabled": True }
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
callback_url: '<string>',
character_orientation: '<string>',
element_list: [{element_id: 123}],
external_task_id: '<string>',
image_url: '<string>',
keep_original_sound: '<string>',
mode: '<string>',
model_name: '<string>',
prompt: '<string>',
video_url: '<string>',
watermark_info: {enabled: true}
})
};
fetch('https://models.kapon.cloud/kling/v1/videos/motion-control', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://models.kapon.cloud/kling/v1/videos/motion-control",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'callback_url' => '<string>',
'character_orientation' => '<string>',
'element_list' => [
[
'element_id' => 123
]
],
'external_task_id' => '<string>',
'image_url' => '<string>',
'keep_original_sound' => '<string>',
'mode' => '<string>',
'model_name' => '<string>',
'prompt' => '<string>',
'video_url' => '<string>',
'watermark_info' => [
'enabled' => true
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://models.kapon.cloud/kling/v1/videos/motion-control"
payload := strings.NewReader("{\n \"callback_url\": \"<string>\",\n \"character_orientation\": \"<string>\",\n \"element_list\": [\n {\n \"element_id\": 123\n }\n ],\n \"external_task_id\": \"<string>\",\n \"image_url\": \"<string>\",\n \"keep_original_sound\": \"<string>\",\n \"mode\": \"<string>\",\n \"model_name\": \"<string>\",\n \"prompt\": \"<string>\",\n \"video_url\": \"<string>\",\n \"watermark_info\": {\n \"enabled\": true\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://models.kapon.cloud/kling/v1/videos/motion-control")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"callback_url\": \"<string>\",\n \"character_orientation\": \"<string>\",\n \"element_list\": [\n {\n \"element_id\": 123\n }\n ],\n \"external_task_id\": \"<string>\",\n \"image_url\": \"<string>\",\n \"keep_original_sound\": \"<string>\",\n \"mode\": \"<string>\",\n \"model_name\": \"<string>\",\n \"prompt\": \"<string>\",\n \"video_url\": \"<string>\",\n \"watermark_info\": {\n \"enabled\": true\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://models.kapon.cloud/kling/v1/videos/motion-control")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"callback_url\": \"<string>\",\n \"character_orientation\": \"<string>\",\n \"element_list\": [\n {\n \"element_id\": 123\n }\n ],\n \"external_task_id\": \"<string>\",\n \"image_url\": \"<string>\",\n \"keep_original_sound\": \"<string>\",\n \"mode\": \"<string>\",\n \"model_name\": \"<string>\",\n \"prompt\": \"<string>\",\n \"video_url\": \"<string>\",\n \"watermark_info\": {\n \"enabled\": true\n }\n}"
response = http.request(request)
puts response.read_body{
"code": 123,
"data": {
"created_at": 123,
"final_balance_deduction": {},
"final_unit_deduction": "<string>",
"platform_id": "<string>",
"task_id": "<string>",
"task_info": {
"external_task_id": "<string>"
},
"task_result": {
"videos": [
{
"duration": "<string>",
"id": "<string>",
"url": "<string>",
"watermark_url": "<string>"
}
]
},
"task_status": "<string>",
"task_status_msg": "<string>",
"updated_at": 123,
"watermark_info": {
"enabled": true
}
},
"data_list": [
{
"created_at": 123,
"final_balance_deduction": {},
"final_unit_deduction": "<string>",
"platform_id": "<string>",
"task_id": "<string>",
"task_info": {
"external_task_id": "<string>"
},
"task_result": {
"videos": [
{
"duration": "<string>",
"id": "<string>",
"url": "<string>",
"watermark_url": "<string>"
}
]
},
"task_status": "<string>",
"task_status_msg": "<string>",
"updated_at": 123,
"watermark_info": {
"enabled": true
}
}
],
"message": "<string>",
"request_id": "<string>"
}Legacy 视频生成
动作控制（Legacy）
接口与可灵官网一致；支持参考图片与动作视频驱动生成视频
POST
/
kling
/
v1
/
videos
/
motion-control
Motion control
curl --request POST \
--url https://models.kapon.cloud/kling/v1/videos/motion-control \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"callback_url": "<string>",
"character_orientation": "<string>",
"element_list": [
{
"element_id": 123
}
],
"external_task_id": "<string>",
"image_url": "<string>",
"keep_original_sound": "<string>",
"mode": "<string>",
"model_name": "<string>",
"prompt": "<string>",
"video_url": "<string>",
"watermark_info": {
"enabled": true
}
}
'import requests
url = "https://models.kapon.cloud/kling/v1/videos/motion-control"
payload = {
"callback_url": "<string>",
"character_orientation": "<string>",
"element_list": [{ "element_id": 123 }],
"external_task_id": "<string>",
"image_url": "<string>",
"keep_original_sound": "<string>",
"mode": "<string>",
"model_name": "<string>",
"prompt": "<string>",
"video_url": "<string>",
"watermark_info": { "enabled": True }
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
callback_url: '<string>',
character_orientation: '<string>',
element_list: [{element_id: 123}],
external_task_id: '<string>',
image_url: '<string>',
keep_original_sound: '<string>',
mode: '<string>',
model_name: '<string>',
prompt: '<string>',
video_url: '<string>',
watermark_info: {enabled: true}
})
};
fetch('https://models.kapon.cloud/kling/v1/videos/motion-control', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://models.kapon.cloud/kling/v1/videos/motion-control",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'callback_url' => '<string>',
'character_orientation' => '<string>',
'element_list' => [
[
'element_id' => 123
]
],
'external_task_id' => '<string>',
'image_url' => '<string>',
'keep_original_sound' => '<string>',
'mode' => '<string>',
'model_name' => '<string>',
'prompt' => '<string>',
'video_url' => '<string>',
'watermark_info' => [
'enabled' => true
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://models.kapon.cloud/kling/v1/videos/motion-control"
payload := strings.NewReader("{\n \"callback_url\": \"<string>\",\n \"character_orientation\": \"<string>\",\n \"element_list\": [\n {\n \"element_id\": 123\n }\n ],\n \"external_task_id\": \"<string>\",\n \"image_url\": \"<string>\",\n \"keep_original_sound\": \"<string>\",\n \"mode\": \"<string>\",\n \"model_name\": \"<string>\",\n \"prompt\": \"<string>\",\n \"video_url\": \"<string>\",\n \"watermark_info\": {\n \"enabled\": true\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://models.kapon.cloud/kling/v1/videos/motion-control")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"callback_url\": \"<string>\",\n \"character_orientation\": \"<string>\",\n \"element_list\": [\n {\n \"element_id\": 123\n }\n ],\n \"external_task_id\": \"<string>\",\n \"image_url\": \"<string>\",\n \"keep_original_sound\": \"<string>\",\n \"mode\": \"<string>\",\n \"model_name\": \"<string>\",\n \"prompt\": \"<string>\",\n \"video_url\": \"<string>\",\n \"watermark_info\": {\n \"enabled\": true\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://models.kapon.cloud/kling/v1/videos/motion-control")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"callback_url\": \"<string>\",\n \"character_orientation\": \"<string>\",\n \"element_list\": [\n {\n \"element_id\": 123\n }\n ],\n \"external_task_id\": \"<string>\",\n \"image_url\": \"<string>\",\n \"keep_original_sound\": \"<string>\",\n \"mode\": \"<string>\",\n \"model_name\": \"<string>\",\n \"prompt\": \"<string>\",\n \"video_url\": \"<string>\",\n \"watermark_info\": {\n \"enabled\": true\n }\n}"
response = http.request(request)
puts response.read_body{
"code": 123,
"data": {
"created_at": 123,
"final_balance_deduction": {},
"final_unit_deduction": "<string>",
"platform_id": "<string>",
"task_id": "<string>",
"task_info": {
"external_task_id": "<string>"
},
"task_result": {
"videos": [
{
"duration": "<string>",
"id": "<string>",
"url": "<string>",
"watermark_url": "<string>"
}
]
},
"task_status": "<string>",
"task_status_msg": "<string>",
"updated_at": 123,
"watermark_info": {
"enabled": true
}
},
"data_list": [
{
"created_at": 123,
"final_balance_deduction": {},
"final_unit_deduction": "<string>",
"platform_id": "<string>",
"task_id": "<string>",
"task_info": {
"external_task_id": "<string>"
},
"task_result": {
"videos": [
{
"duration": "<string>",
"id": "<string>",
"url": "<string>",
"watermark_url": "<string>"
}
]
},
"task_status": "<string>",
"task_status_msg": "<string>",
"updated_at": 123,
"watermark_info": {
"enabled": true
}
}
],
"message": "<string>",
"request_id": "<string>"
}- 路径
POST /kling/v1/videos/motion-control - 与官网一致：本页请求体、字段命名与返回结构与可灵官网保持一致
- 字段详解：请参考官网权威文档
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model_name | string | 否 | 模型名称，仅支持 kling-v2-6、kling-v3，默认 kling-v2-6 |
prompt | string | 否 | 文本提示词，可用于补充元素或运镜描述 |
image_url | string | 是 | 参考图片 URL 或 Base64 |
video_url | string | 是 | 参考动作视频 URL |
element_list | array | 否 | 主体引用列表，当前最多 1 个主体 |
keep_original_sound | string | 否 | 是否保留原声：yes、no，默认 yes |
character_orientation | string | 是 | 人物朝向：image、video |
mode | string | 是 | 生成模式：std、pro |
watermark_info | object | 否 | 是否生成含水印结果 |
callback_url | string | 否 | 回调通知地址 |
external_task_id | string | 否 | 自定义任务 ID |
{
"element_list": [
{
"element_id": 829836802793406551
}
]
}
character_orientation=image时，参考视频时长不得超过 10 秒；character_orientation=video时，参考视频时长不得超过 30 秒；keep_original_sound仅支持yes/no；mode仅支持std/pro；model_name仅支持kling-v2-6/kling-v3。
场景：参考图片 + 参考动作视频生成视频
curl --request POST \
--url https://models.kapon.cloud/kling/v1/videos/motion-control \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model_name": "kling-v2-6",
"image_url": "https://example.com/ref.png",
"prompt": "女孩穿着灰色宽松T恤和牛仔短裤",
"video_url": "https://example.com/motion.mp4",
"keep_original_sound": "yes",
"character_orientation": "image",
"mode": "pro",
"external_task_id": "motion-demo-001"
}'
{
"code": 0,
"message": "success",
"request_id": "req_1735558800_motion123",
"data": {
"task_id": "task_01JGHN...",
"task_info": {
"external_task_id": "motion-demo-001"
},
"task_status": "submitted",
"created_at": 1735558800000,
"updated_at": 1735558800000
}
}
# 查询单个任务
curl "https://models.kapon.cloud/kling/v1/videos/motion-control/$TASK_ID" \
-H "Authorization: Bearer $TOKEN"
# 查询任务列表
curl "https://models.kapon.cloud/kling/v1/videos/motion-control?pageNum=1&pageSize=30" \
-H "Authorization: Bearer $TOKEN"
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
回调通知地址
人物朝向 image/video
主体引用列表
Show child attributes
Show child attributes
自定义任务 ID
参考图片 URL 或 Base64
是否保留原声 yes/no
生成模式 std/pro
模型名称，默认 kling-v2-6
文本提示词
参考动作视频 URL
水印信息
Show child attributes
Show child attributes