#查询状态与下载视频(可灵格式)
#端点
- 文生视频:
GET /kling/v1/videos/text2video/{task_id} - 图生视频:
GET /kling/v1/videos/image2video/{task_id}
#请求示例
查询状态与获取视频(文生视频用 text2video 路径,图生视频把路径换成 image2video):
cURL
Python
Node.js
# 查询状态:图生视频把 text2video 换成 image2video
curl https://api-model.shuntianchuang.cn/kling/v1/videos/text2video/task_xxxxxxxx \
-H "Authorization: Bearer sk-你的令牌"
# 任务 succeed 后,从 data.task_result.videos[0].url 取视频直链下载
curl -o kling.mp4 "data.task_result.videos[0] 中返回的视频URL"import time
import requests
BASE = "https://api-model.shuntianchuang.cn"
HEADERS = {"Authorization": "Bearer sk-你的令牌"}
task_id = "task_xxxxxxxx" # 提交响应中的 data.task_id
while True:
data = requests.get(
f"{BASE}/kling/v1/videos/text2video/{task_id}", # 图生视频用 image2video
headers=HEADERS,
).json()["data"]
print(data["task_status"])
if data["task_status"] in ("succeed", "failed"):
break
time.sleep(10)
if data["task_status"] == "succeed":
url = data["task_result"]["videos"][0]["url"]
with open("kling.mp4", "wb") as f:
f.write(requests.get(url).content)
print("已保存 kling.mp4")
else:
raise SystemExit(f"任务失败:{data.get('task_status_msg')}")import fs from 'node:fs';
const BASE = 'https://api-model.shuntianchuang.cn';
const HEADERS = { Authorization: 'Bearer sk-你的令牌' };
const taskId = 'task_xxxxxxxx'; // 提交响应中的 data.task_id
let data;
while (true) {
const resp = await fetch(`${BASE}/kling/v1/videos/text2video/${taskId}`, {
headers: HEADERS,
}); // 图生视频用 image2video
data = (await resp.json()).data;
console.log(data.task_status);
if (data.task_status === 'succeed' || data.task_status === 'failed') break;
await new Promise((resolve) => setTimeout(resolve, 10_000));
}
if (data.task_status !== 'succeed')
throw new Error(`任务失败:${data.task_status_msg}`);
const video = await fetch(data.task_result.videos[0].url);
fs.writeFileSync('kling.mp4', Buffer.from(await video.arrayBuffer()));#响应体
查询响应为可灵格式信封,业务数据在 data 内,关键字段如下:
data 字段 | 说明 |
|---|---|
task_id | 任务 ID |
task_status | 状态流转:submitted(已提交)→ processing(生成中)→ succeed(成功)或 failed(失败) |
task_status_msg | 失败原因(成功时为空) |
task_result.videos[] | 成功后的视频列表,url 为下载直链、duration 为成片秒数 |
create_time / update_time | 任务创建 / 更新时间(毫秒时间戳);旧版兼容镜像 created_at / updated_at 同值 |
final_unit_deduction | 本次任务的上游实际用量(字符串),可用于对账 |
#响应示例
{
"code": 0,
"message": "SUCCEED",
"data": {
"task_id": "task_xxxxxxxx",
"task_status": "succeed",
"task_status_msg": "",
"create_time": 1790573568000,
"update_time": 1790573782998,
"created_at": 1790573568000,
"updated_at": 1790573782998,
"final_unit_deduction": "250000",
"task_result": {
"videos": [
{
"id": "933421703588872232",
"url": "https://aigc-output-video-xxxx.cos.ap-guangzhou.myqcloud.com/xxxx.mp4?q-sign-algorithm=sha1&...",
"duration": "5.083"
}
]
}
}
}WARNING
成片 url 为上游签名直链,约 45 分钟后失效,拿到后请立即下载转存,勿当作长期存储链接分发。
