#旧版使用指南(v2.5-turbo)
本页面向 2026-09 前接入、只使用 kling-video-v2.5-turbo 的存量用户,仅保留该模型实际用到的字段。新项目或需要其他可灵模型的用户请移步新版提交任务。
#端点
- 文生视频:
POST /kling/v1/videos/text2video - 图生视频:
POST /kling/v1/videos/image2video - 查询:
GET /kling/v1/videos/{text2video|image2video}/{task_id}
#请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 固定 kling-video-v2.5-turbo(model_name 同样有效) |
prompt | string | 是 | 视频描述 |
image | string | 否 | 图生视频首帧图片(URL 或 Base64);带此字段按图生视频处理。支持 jpg / jpeg / png,≤ 50MB,宽高均 ≥ 300px |
mode | string | 否 | 分辨率档位:std(720p)/ pro(1080p),不传默认 std |
duration | string | 否 | 时长(秒):"5" / "10",不传默认 "5" |
size | string | 否 | 画幅,仅文生视频有效:1920x1080 / 1280x720 → 16:9,720x1280 / 1080x1920 → 9:16,其余 → 1:1。图生视频画幅跟随图片 |
metadata | object | 否 | 附加参数对象:metadata.image_tail(尾帧图,须伴随 image,自动强制 1080p)与 metadata.negative_prompt(反向提示词)放这里 |
NOTE
v2.5-turbo 不支持音频(audio)、4k 分辨率(ultra)、元素 / 音色引用(el- / vo-)与多镜头,这些旧字段会被忽略;需要时请改用新版字段并搭配对应模型。
#请求示例
cURL
Python
Node.js
# 文生视频
curl -X POST https://api-model.shuntianchuang.cn/kling/v1/videos/text2video \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-video-v2.5-turbo",
"prompt": "一只橘猫在草地上追蝴蝶,电影感镜头,缓慢推近",
"duration": "5",
"size": "1280x720",
"mode": "std"
}'# 图生视频 + 尾帧
curl -X POST https://api-model.shuntianchuang.cn/kling/v1/videos/image2video \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-video-v2.5-turbo",
"image": "https://example.com/first-frame.jpg",
"prompt": "让画面中的猫跑起来,镜头缓慢推近",
"metadata": {"image_tail": "https://example.com/last-frame.jpg"}
}'import requests
BASE = "https://api-model.shuntianchuang.cn"
resp = requests.post(
f"{BASE}/kling/v1/videos/text2video", # 图生视频改用 image2video
headers={
"Authorization": "Bearer sk-你的令牌",
"Content-Type": "application/json",
},
json={
"model": "kling-video-v2.5-turbo",
"prompt": "一只橘猫在草地上追蝴蝶,电影感镜头,缓慢推近",
"duration": "5",
"size": "1280x720",
"mode": "std",
},
)
task = resp.json()
print(task["task_id"], task["data"]["task_status"]) # 记住任务 ID 用于轮询
# 图生视频:端点换成 f"{BASE}/kling/v1/videos/image2video",
# 并在 json 中加 "image"(首帧);尾帧放 "metadata": {"image_tail": "..."}// 文生视频;图生视频把 text2video 换成 image2video,并加 image 字段
const resp = await fetch(
'https://api-model.shuntianchuang.cn/kling/v1/videos/text2video',
{
method: 'POST',
headers: {
Authorization: 'Bearer sk-你的令牌',
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'kling-video-v2.5-turbo',
prompt: '一只橘猫在草地上追蝴蝶,电影感镜头,缓慢推近',
duration: '5',
size: '1280x720',
mode: 'std',
}),
},
);
const task = await resp.json();
console.log(task.task_id, task.data.task_status); // 记住任务 ID 用于轮询#查询与下载
用提交返回的任务 ID 轮询(图生视频把路径换成 image2video):
curl https://api-model.shuntianchuang.cn/kling/v1/videos/text2video/task_xxxxxxxx \
-H "Authorization: Bearer sk-你的令牌"data 字段 | 说明 |
|---|---|
task_id | 任务 ID;提交响应顶层同样返回一份 task_id |
task_status | 状态流转:submitted(已提交)→ processing(生成中)→ succeed(成功)或 failed(失败) |
task_status_msg | 失败原因,仅失败时非空 |
task_result.videos[] | 成功后的视频列表,每项含 id、url(下载直链,链接有时效,请及时下载转存)、duration(秒) |
final_unit_deduction | 成功时的实际消耗(字符串,单位 TokenHub token),仅成功时返回 |
created_at / updated_at | 任务创建 / 最后更新时间戳(毫秒),仅成功时返回 |
{
"code": 0,
"message": "SUCCEED",
"data": {
"task_id": "task_9AUeg9lOftqbEG1kgmcYngreXu0aJe20",
"task_status": "succeed",
"task_status_msg": "",
"task_result": {
"videos": [
{ "id": "937575610917490712", "url": "https://xxxx/video.mp4", "duration": "5.083" }
]
},
"create_time": 1791563923000,
"update_time": 1791564087821,
"created_at": 1791563923000,
"updated_at": 1791564087821,
"final_unit_deduction": "250000"
}
}NOTE
code 为整数 0 表示受理 / 查询成功(message 为 "SUCCEED"),业务状态以 data.task_status 为准。
