跳转到主要内容

Kling 任务查询

可查询的任务路径

路径用途
GET /kling/v1/videos/text2video/{task_id}查询文生视频任务
GET /kling/v1/videos/image2video/{task_id}查询图生视频任务
GET /kling/v1/videos/multi-image2video/{task_id}查询参考图生视频任务
GET /kling/v1/videos/omni-video/{task_id}查询 Omni 视频任务
GET /kling/v1/images/generations/{task_id}查询图片生成任务
GET /kling/v1/images/kolors-virtual-try-on/{task_id}查询虚拟试穿任务

响应格式

所有 Kling 查询接口统一返回同一类任务结构:
{
  "code": "success",
  "message": "",
  "data": {
    "error": null,
    "format": "mp4",
    "metadata": null,
    "status": "succeeded",
    "task_id": "866168216002236456",
    "url": "https://media.crazyrouter.com/task-artifacts/2026/03/26/50/textGenerate/866168216002236456.m4v"
  }
}

排队中

{
  "code": "success",
  "message": "",
  "data": {
    "error": null,
    "format": "mp4",
    "metadata": null,
    "status": "queued",
    "task_id": "task_abc123",
    "url": ""
  }
}

处理中

{
  "code": "success",
  "message": "",
  "data": {
    "error": null,
    "format": "mp4",
    "metadata": null,
    "status": "processing",
    "task_id": "task_abc123",
    "url": ""
  }
}

已完成

{
  "code": "success",
  "message": "",
  "data": {
    "error": null,
    "format": "mp4",
    "metadata": null,
    "status": "succeeded",
    "task_id": "866168216002236456",
    "url": "https://media.crazyrouter.com/task-artifacts/2026/03/26/50/textGenerate/866168216002236456.m4v"
  }
}

失败

{
  "code": "success",
  "message": "",
  "data": {
    "error": {
      "message": "content moderation failed",
      "code": "task_failed"
    },
    "format": "mp4",
    "metadata": null,
    "status": "failed",
    "task_id": "task_abc123",
    "url": ""
  }
}

任务状态

状态说明
queued已提交或排队中
processing正在生成
succeeded已完成,url 可直接访问
failed终态失败

完整流程示例

Python
import requests
import time

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://crazyrouter.com"
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

# 1. 提交文生视频任务
resp = requests.post(
    f"{BASE_URL}/kling/v1/videos/text2video",
    headers=headers,
    json={
        "model_name": "kling-v2-5-turbo",
        "prompt": "一只猫咪在花园里追蝴蝶",
        "duration": "5",
        "aspect_ratio": "16:9"
    }
)
task_id = resp.json()["task_id"]

# 2. 轮询查询
while True:
    resp = requests.get(
        f"{BASE_URL}/kling/v1/videos/text2video/{task_id}",
        headers=headers
    )
    data = resp.json()["data"]

    if data["status"] == "succeeded":
        print(f"视频地址: {data['url']}")
        break
    if data["status"] == "failed":
        print(f"失败: {data['error']}")
        break

    time.sleep(10)
Kling 的标准视频、Omni 视频、图片和试穿任务结果都可能返回站内归档地址 media.crazyrouter.com/...。对客户端来说,优先消费 url 即可,无需再解析上游原始 CDN。