Kling 任务查询

Kling 任务提交后，通过 OpenAI 兼容入口按任务 ID 轮询状态与结果。

GET /v1/videos/{task_id}

将路径中的 {task_id} 替换为 视频生成 返回的任务 ID。完成后从 video_url（或 metadata.url）读取结果。

请求头

名称	类型	必填	说明
	string	是	请求身份认证。使用 Bearer Token，示例：

请求参数

名称	类型	必填	说明
	string	是	路径参数，与生成接口返回的 id 或 task_id 一致

请求示例

curl https://octopusx.ai/v1/videos/task_ZOAIupBoCLMo3dmUGcrKUcUEUnCLctc6 \
  -H "Authorization: Bearer <token>"

响应示例

处理中

{
  "id": "task_ZOAIupBoCLMo3dmUGcrKUcUEUnCLctc6",
  "object": "video",
  "model": "Kling-3.0-Omni",
  "status": "processing",
  "progress": 50,
  "created_at": 1774494511
}

已完成

{
  "id": "task_ZOAIupBoCLMo3dmUGcrKUcUEUnCLctc6",
  "object": "video",
  "model": "Kling-3.0-Omni",
  "status": "completed",
  "progress": 100,
  "created_at": 1774494511,
  "completed_at": 1774494622,
  "metadata": {
    "url": "https://example.com/video/aigcVideoGenFile.mp4"
  },
  "video_url": "https://example.com/video/aigcVideoGenFile.mp4"
}

响应字段

名称	类型	说明
	string	任务 ID
	string	固定为
	string	模型名称
	string	任务状态：、、、、
	integer	进度百分比 0–100
	integer	创建时间戳
	integer	完成时间戳（完成时返回）
	string	视频地址（在 metadata 中）
	string	视频地址（与 相同）

相关接口

• 视频系列概览
• Kling 视频生成
• 错误码查询