Kling 任务查询

curl https://gogogotoken.com/kling/v1/videos/text2video/task_xxxxxxxxxxxxxxxx \
  -H "Authorization: Bearer YOUR_API_KEY"

curl https://gogogotoken.com/kling/v1/videos/image2video/task_xxxxxxxxxxxxxxxx \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "code": "success",
  "data": {
    "task_id": "task_xxxxxxxxxxxxxxxx",
    "status": "IN_PROGRESS",
    "progress": "50%",
    "platform": "50"
  }
}

{
  "code": "success",
  "data": {
    "task_id": "task_xxxxxxxxxxxxxxxx",
    "status": "SUCCESS",
    "progress": "100%",
    "result_url": "https://example.cdn.example.com/....mp4",
    "data": {
      "status": "completed",
      "duration": "5.041",
      "final_unit_deduction": "1.5",
      "video_url": "https://example.cdn.example.com/....mp4"
    }
  }
}

{
  "code": "success",
  "data": {
    "task_id": "task_xxxxxxxxxxxxxxxx",
    "status": "FAILURE",
    "fail_reason": "upstream error message"
  }
}

GET

kling

videos

text2video

{task_id}

curl https://gogogotoken.com/kling/v1/videos/text2video/task_xxxxxxxxxxxxxxxx \
  -H "Authorization: Bearer YOUR_API_KEY"

curl https://gogogotoken.com/kling/v1/videos/image2video/task_xxxxxxxxxxxxxxxx \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "code": "success",
  "data": {
    "task_id": "task_xxxxxxxxxxxxxxxx",
    "status": "IN_PROGRESS",
    "progress": "50%",
    "platform": "50"
  }
}

{
  "code": "success",
  "data": {
    "task_id": "task_xxxxxxxxxxxxxxxx",
    "status": "SUCCESS",
    "progress": "100%",
    "result_url": "https://example.cdn.example.com/....mp4",
    "data": {
      "status": "completed",
      "duration": "5.041",
      "final_unit_deduction": "1.5",
      "video_url": "https://example.cdn.example.com/....mp4"
    }
  }
}

{
  "code": "success",
  "data": {
    "task_id": "task_xxxxxxxxxxxxxxxx",
    "status": "FAILURE",
    "fail_reason": "upstream error message"
  }
}

任务提交成功后返回 task_id（与 id 相同）。轮询直至 data.status 为 SUCCESS 或 FAILURE。

GET /kling/v1/videos/* 查询返回 {code, data: TaskDto}，其中 status 为大写（如 IN_PROGRESS、SUCCESS），视频地址在 data.result_url。这与 Seedance 主路径 GET /v1/video/generations/{task_id} 结构相同，但字段含义与 Seedance 的 data.data.usage 不同。若需要 OpenAI Video 兼容响应（小写 status、metadata.url），请改用 GET /v1/videos/{task_id}（见下文「OpenAI 格式查询」）。

curl https://gogogotoken.com/kling/v1/videos/text2video/task_xxxxxxxxxxxxxxxx \
  -H "Authorization: Bearer YOUR_API_KEY"

curl https://gogogotoken.com/kling/v1/videos/image2video/task_xxxxxxxxxxxxxxxx \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "code": "success",
  "data": {
    "task_id": "task_xxxxxxxxxxxxxxxx",
    "status": "IN_PROGRESS",
    "progress": "50%",
    "platform": "50"
  }
}

{
  "code": "success",
  "data": {
    "task_id": "task_xxxxxxxxxxxxxxxx",
    "status": "SUCCESS",
    "progress": "100%",
    "result_url": "https://example.cdn.example.com/....mp4",
    "data": {
      "status": "completed",
      "duration": "5.041",
      "final_unit_deduction": "1.5",
      "video_url": "https://example.cdn.example.com/....mp4"
    }
  }
}

{
  "code": "success",
  "data": {
    "task_id": "task_xxxxxxxxxxxxxxxx",
    "status": "FAILURE",
    "fail_reason": "upstream error message"
  }
}

状态说明（`data.status`）

值	含义
`SUBMITTED` / `QUEUED`	已提交 / 排队中
`IN_PROGRESS`	生成中
`SUCCESS`	成功，视频地址见 `data.result_url`
`FAILURE`	失败，见 `data.fail_reason`

data.data 为上游原始 JSON（含 duration、final_unit_deduction 等），供调试与对账参考。

轮询建议

间隔 3–10 秒 查询一次；成片通常需数十秒至数分钟。
文生视频与图生视频可用任意一条 Kling 查询路径（text2video / image2video），只要 task_id 正确即可。
成功后的 result_url 多为上游 带签名临时链接，请在有效期内下载或转存。
计费在任务成功完成后按上游积分结算；详见 Kling 模型与计费。

OpenAI 格式查询（可选）

GET /v1/videos/{task_id}

返回扁平 OpenAI Video JSON，例如：

{
  "id": "task_xxxxxxxxxxxxxxxx",
  "object": "video",
  "status": "completed",
  "progress": 100,
  "seconds": "5.041",
  "metadata": {
    "url": "https://example.cdn.example.com/....mp4"
  }
}

此处 status 为小写（queued / in_progress / completed / failed）。

下载视频

拿到 result_url 或 metadata.url 后可直接 HTTP 下载；也可使用（需登录或 API Key）：

GET /v1/videos/{task_id}/content

开始使用

图片生成

对话模型

Seedance 视频

Kling 视频

Seedance 素材

兼容接口

账户与计费

状态说明（`data.status`）

轮询建议

OpenAI 格式查询（可选）

下载视频

​状态说明（data.status）

​轮询建议

​OpenAI 格式查询（可选）

​下载视频

状态说明（`data.status`）

轮询建议

OpenAI 格式查询（可选）

下载视频