Text to video
curl --request POST \
--url https://models.kapon.cloud/kling/v1/videos/text2video \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"aspect_ratio": "<string>",
"callback_url": "<string>",
"camera_control": {
"config": {
"horizontal": 123,
"pan": 123,
"roll": 123,
"tilt": 123,
"vertical": 123,
"zoom": 123
},
"type": "<string>"
},
"cfg_scale": 123,
"duration": "<string>",
"external_task_id": "<string>",
"mode": "<string>",
"model_name": "<string>",
"multi_prompt": [
{
"duration": "<string>",
"index": 123,
"prompt": "<string>"
}
],
"multi_shot": true,
"negative_prompt": "<string>",
"prompt": "<string>",
"shot_type": "<string>",
"sound": "<string>",
"watermark_info": {
"enabled": true
}
}
'import requests
url = "https://models.kapon.cloud/kling/v1/videos/text2video"
payload = {
"aspect_ratio": "<string>",
"callback_url": "<string>",
"camera_control": {
"config": {
"horizontal": 123,
"pan": 123,
"roll": 123,
"tilt": 123,
"vertical": 123,
"zoom": 123
},
"type": "<string>"
},
"cfg_scale": 123,
"duration": "<string>",
"external_task_id": "<string>",
"mode": "<string>",
"model_name": "<string>",
"multi_prompt": [
{
"duration": "<string>",
"index": 123,
"prompt": "<string>"
}
],
"multi_shot": True,
"negative_prompt": "<string>",
"prompt": "<string>",
"shot_type": "<string>",
"sound": "<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({
aspect_ratio: '<string>',
callback_url: '<string>',
camera_control: {
config: {horizontal: 123, pan: 123, roll: 123, tilt: 123, vertical: 123, zoom: 123},
type: '<string>'
},
cfg_scale: 123,
duration: '<string>',
external_task_id: '<string>',
mode: '<string>',
model_name: '<string>',
multi_prompt: [{duration: '<string>', index: 123, prompt: '<string>'}],
multi_shot: true,
negative_prompt: '<string>',
prompt: '<string>',
shot_type: '<string>',
sound: '<string>',
watermark_info: {enabled: true}
})
};
fetch('https://models.kapon.cloud/kling/v1/videos/text2video', 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/text2video",
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([
'aspect_ratio' => '<string>',
'callback_url' => '<string>',
'camera_control' => [
'config' => [
'horizontal' => 123,
'pan' => 123,
'roll' => 123,
'tilt' => 123,
'vertical' => 123,
'zoom' => 123
],
'type' => '<string>'
],
'cfg_scale' => 123,
'duration' => '<string>',
'external_task_id' => '<string>',
'mode' => '<string>',
'model_name' => '<string>',
'multi_prompt' => [
[
'duration' => '<string>',
'index' => 123,
'prompt' => '<string>'
]
],
'multi_shot' => true,
'negative_prompt' => '<string>',
'prompt' => '<string>',
'shot_type' => '<string>',
'sound' => '<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/text2video"
payload := strings.NewReader("{\n \"aspect_ratio\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"camera_control\": {\n \"config\": {\n \"horizontal\": 123,\n \"pan\": 123,\n \"roll\": 123,\n \"tilt\": 123,\n \"vertical\": 123,\n \"zoom\": 123\n },\n \"type\": \"<string>\"\n },\n \"cfg_scale\": 123,\n \"duration\": \"<string>\",\n \"external_task_id\": \"<string>\",\n \"mode\": \"<string>\",\n \"model_name\": \"<string>\",\n \"multi_prompt\": [\n {\n \"duration\": \"<string>\",\n \"index\": 123,\n \"prompt\": \"<string>\"\n }\n ],\n \"multi_shot\": true,\n \"negative_prompt\": \"<string>\",\n \"prompt\": \"<string>\",\n \"shot_type\": \"<string>\",\n \"sound\": \"<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/text2video")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"aspect_ratio\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"camera_control\": {\n \"config\": {\n \"horizontal\": 123,\n \"pan\": 123,\n \"roll\": 123,\n \"tilt\": 123,\n \"vertical\": 123,\n \"zoom\": 123\n },\n \"type\": \"<string>\"\n },\n \"cfg_scale\": 123,\n \"duration\": \"<string>\",\n \"external_task_id\": \"<string>\",\n \"mode\": \"<string>\",\n \"model_name\": \"<string>\",\n \"multi_prompt\": [\n {\n \"duration\": \"<string>\",\n \"index\": 123,\n \"prompt\": \"<string>\"\n }\n ],\n \"multi_shot\": true,\n \"negative_prompt\": \"<string>\",\n \"prompt\": \"<string>\",\n \"shot_type\": \"<string>\",\n \"sound\": \"<string>\",\n \"watermark_info\": {\n \"enabled\": true\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://models.kapon.cloud/kling/v1/videos/text2video")
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 \"aspect_ratio\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"camera_control\": {\n \"config\": {\n \"horizontal\": 123,\n \"pan\": 123,\n \"roll\": 123,\n \"tilt\": 123,\n \"vertical\": 123,\n \"zoom\": 123\n },\n \"type\": \"<string>\"\n },\n \"cfg_scale\": 123,\n \"duration\": \"<string>\",\n \"external_task_id\": \"<string>\",\n \"mode\": \"<string>\",\n \"model_name\": \"<string>\",\n \"multi_prompt\": [\n {\n \"duration\": \"<string>\",\n \"index\": 123,\n \"prompt\": \"<string>\"\n }\n ],\n \"multi_shot\": true,\n \"negative_prompt\": \"<string>\",\n \"prompt\": \"<string>\",\n \"shot_type\": \"<string>\",\n \"sound\": \"<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
/
text2video
Text to video
curl --request POST \
--url https://models.kapon.cloud/kling/v1/videos/text2video \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"aspect_ratio": "<string>",
"callback_url": "<string>",
"camera_control": {
"config": {
"horizontal": 123,
"pan": 123,
"roll": 123,
"tilt": 123,
"vertical": 123,
"zoom": 123
},
"type": "<string>"
},
"cfg_scale": 123,
"duration": "<string>",
"external_task_id": "<string>",
"mode": "<string>",
"model_name": "<string>",
"multi_prompt": [
{
"duration": "<string>",
"index": 123,
"prompt": "<string>"
}
],
"multi_shot": true,
"negative_prompt": "<string>",
"prompt": "<string>",
"shot_type": "<string>",
"sound": "<string>",
"watermark_info": {
"enabled": true
}
}
'import requests
url = "https://models.kapon.cloud/kling/v1/videos/text2video"
payload = {
"aspect_ratio": "<string>",
"callback_url": "<string>",
"camera_control": {
"config": {
"horizontal": 123,
"pan": 123,
"roll": 123,
"tilt": 123,
"vertical": 123,
"zoom": 123
},
"type": "<string>"
},
"cfg_scale": 123,
"duration": "<string>",
"external_task_id": "<string>",
"mode": "<string>",
"model_name": "<string>",
"multi_prompt": [
{
"duration": "<string>",
"index": 123,
"prompt": "<string>"
}
],
"multi_shot": True,
"negative_prompt": "<string>",
"prompt": "<string>",
"shot_type": "<string>",
"sound": "<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({
aspect_ratio: '<string>',
callback_url: '<string>',
camera_control: {
config: {horizontal: 123, pan: 123, roll: 123, tilt: 123, vertical: 123, zoom: 123},
type: '<string>'
},
cfg_scale: 123,
duration: '<string>',
external_task_id: '<string>',
mode: '<string>',
model_name: '<string>',
multi_prompt: [{duration: '<string>', index: 123, prompt: '<string>'}],
multi_shot: true,
negative_prompt: '<string>',
prompt: '<string>',
shot_type: '<string>',
sound: '<string>',
watermark_info: {enabled: true}
})
};
fetch('https://models.kapon.cloud/kling/v1/videos/text2video', 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/text2video",
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([
'aspect_ratio' => '<string>',
'callback_url' => '<string>',
'camera_control' => [
'config' => [
'horizontal' => 123,
'pan' => 123,
'roll' => 123,
'tilt' => 123,
'vertical' => 123,
'zoom' => 123
],
'type' => '<string>'
],
'cfg_scale' => 123,
'duration' => '<string>',
'external_task_id' => '<string>',
'mode' => '<string>',
'model_name' => '<string>',
'multi_prompt' => [
[
'duration' => '<string>',
'index' => 123,
'prompt' => '<string>'
]
],
'multi_shot' => true,
'negative_prompt' => '<string>',
'prompt' => '<string>',
'shot_type' => '<string>',
'sound' => '<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/text2video"
payload := strings.NewReader("{\n \"aspect_ratio\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"camera_control\": {\n \"config\": {\n \"horizontal\": 123,\n \"pan\": 123,\n \"roll\": 123,\n \"tilt\": 123,\n \"vertical\": 123,\n \"zoom\": 123\n },\n \"type\": \"<string>\"\n },\n \"cfg_scale\": 123,\n \"duration\": \"<string>\",\n \"external_task_id\": \"<string>\",\n \"mode\": \"<string>\",\n \"model_name\": \"<string>\",\n \"multi_prompt\": [\n {\n \"duration\": \"<string>\",\n \"index\": 123,\n \"prompt\": \"<string>\"\n }\n ],\n \"multi_shot\": true,\n \"negative_prompt\": \"<string>\",\n \"prompt\": \"<string>\",\n \"shot_type\": \"<string>\",\n \"sound\": \"<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/text2video")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"aspect_ratio\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"camera_control\": {\n \"config\": {\n \"horizontal\": 123,\n \"pan\": 123,\n \"roll\": 123,\n \"tilt\": 123,\n \"vertical\": 123,\n \"zoom\": 123\n },\n \"type\": \"<string>\"\n },\n \"cfg_scale\": 123,\n \"duration\": \"<string>\",\n \"external_task_id\": \"<string>\",\n \"mode\": \"<string>\",\n \"model_name\": \"<string>\",\n \"multi_prompt\": [\n {\n \"duration\": \"<string>\",\n \"index\": 123,\n \"prompt\": \"<string>\"\n }\n ],\n \"multi_shot\": true,\n \"negative_prompt\": \"<string>\",\n \"prompt\": \"<string>\",\n \"shot_type\": \"<string>\",\n \"sound\": \"<string>\",\n \"watermark_info\": {\n \"enabled\": true\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://models.kapon.cloud/kling/v1/videos/text2video")
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 \"aspect_ratio\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"camera_control\": {\n \"config\": {\n \"horizontal\": 123,\n \"pan\": 123,\n \"roll\": 123,\n \"tilt\": 123,\n \"vertical\": 123,\n \"zoom\": 123\n },\n \"type\": \"<string>\"\n },\n \"cfg_scale\": 123,\n \"duration\": \"<string>\",\n \"external_task_id\": \"<string>\",\n \"mode\": \"<string>\",\n \"model_name\": \"<string>\",\n \"multi_prompt\": [\n {\n \"duration\": \"<string>\",\n \"index\": 123,\n \"prompt\": \"<string>\"\n }\n ],\n \"multi_shot\": true,\n \"negative_prompt\": \"<string>\",\n \"prompt\": \"<string>\",\n \"shot_type\": \"<string>\",\n \"sound\": \"<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>"
}
请求参数
摄像机控制
补充约束
示例响应（创建任务）
任务状态说明
multi_shot=true 且 shot_type=customize 时使用 multi_prompt，无需顶层 prompt；普通单镜头和智能分镜仍需 prompt。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model_name | string | 否 | 模型名称，默认 kling-v1。可选：kling-v1、kling-v1-6、kling-v2-master、kling-v2-1-master、kling-v2-5-turbo、kling-v2-6、kling-v3 |
prompt | string | 条件必填 | 正向文本提示词 |
multi_shot | boolean | 否 | 是否多镜头，默认false，3.0支持 |
shot_type | string | 条件必填 | 多镜头时为 customize 或 intelligence |
multi_prompt | array | 条件必填 | 自定义分镜 {index,prompt,duration}；序号从1递增，各段时长之和等于总时长，最多6段 |
negative_prompt | string | 否 | 负向文本提示词 |
cfg_scale | number | 否 | 生成自由度 [0, 1]，仅 kling-v1/kling-v1-5/kling-v1-6 支持 |
sound | string | 否 | 是否生成声音：on/off（仅 kling-v2-6 支持） |
mode | string | 否 | 生成模式：std（标准）、pro（专业），默认 std |
camera_control | object | 否 | 摄像机运动控制，详见下方说明 |
aspect_ratio | string | 否 | 画面纵横比：16:9、9:16、1:1，默认 16:9 |
duration | string | 否 | 视频时长：5（5秒）、10（10秒），默认 5 |
watermark_info | object | 否 | 是否生成含水印结果 |
callback_url | string | 否 | 回调通知地址 |
external_task_id | string | 否 | 自定义任务ID（幂等控制） |
{
"camera_control": {
"type": "simple", // simple, down_back, forward_up, right_turn_forward, left_turn_forward
"config": { // type=simple 时必填
"horizontal": 5 // 水平运镜 [-10, 10]
// 其他可选：vertical, pan, tilt, roll, zoom（只能有一个非零）
}
}
}
prompt不能超过 2500 字符。cfg_scale仅kling-v1/kling-v1-5/kling-v1-6支持，kling-v2系列不支持。camera_control.type=simple时，config只能有一个字段为非零值，其余必须为 0。- 历史输入
kling-v2-5会归一为kling-v2-5-turbo；对外展示和渠道自动填充使用 canonical 模型名。 kling-v3-omni请使用 Omni 视频入口/kling/v1/videos/omni-video。Kling 3.0 Turbo暂未确认官方可调用 schema，当前不放行。
场景一：简单文生视频
curl --request POST \
--url https://models.kapon.cloud/kling/v1/videos/text2video \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model_name": "kling-v1",
"prompt": "A man picks up a book, then reads with focused expression.",
"mode": "std",
"duration": "5",
"aspect_ratio": "16:9"
}'
{
"code": 0,
"message": "success",
"request_id": "req_1735558800_abc123",
"data": {
"task_id": "task_01JGHK...",
"task_status": "submitted",
"created_at": 1735558800000,
"updated_at": 1735558800000
}
}
场景二：带摄像机运镜
curl --request POST \
--url https://models.kapon.cloud/kling/v1/videos/text2video \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model_name": "kling-v2-master",
"prompt": "Sunset over mountains, golden light spreading across valleys",
"mode": "pro",
"duration": "10",
"aspect_ratio": "16:9",
"camera_control": {
"type": "forward_up"
}
}'
场景三：V2.6 声音控制
curl --request POST \
--url https://models.kapon.cloud/kling/v1/videos/text2video \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model_name": "kling-v2-6",
"prompt": "A calm ocean scene with gentle waves",
"mode": "std",
"duration": "5",
"aspect_ratio": "16:9",
"sound": "on"
}'
| 状态 | 含义 |
|---|---|
submitted | 已提交 |
processing | 处理中 |
succeed | 成功 |
failed | 失败 |
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
画面纵横比：16:9, 9:16, 1:1
回调通知地址
摄像机运动控制
Show child attributes
Show child attributes
生成视频的自由度 [0, 1]
视频时长：5, 10
自定义任务ID
生成模式：std, pro
模型名称，默认kling-v1
Show child attributes
Show child attributes
负向文本提示词
正向文本提示词，必须
是否生成声音：on/off
水印信息
Show child attributes
Show child attributes