查询视频任务（通用格式）

开发中

Draw

https://draw.openai-next.com

GET

/v1/videos/{task_id}

查询异步视频生成任务状态。

鉴权：Authorization: Bearer {{API_KEY}}

请求：GET /v1/videos/{task_id}

状态：queued（排队中）、in_progress（生成中）、completed（已完成）、failed（失败）。

完成响应示例：

{
  "task_id": "task_xxx",
  "status": "completed",
  "progress": 100,
  "video_url": "https://example.com/generated/xxxx.mp4",
  "data": [{ "url": "https://example.com/generated/xxxx.mp4" }]
}

优先读取顶层 video_url；如不存在，也可读取 data[0].url。建议每 3–5 秒轮询一次；任务已提交后不要为同一任务重复 POST。仅记录相对 API 路径与响应形状，不包含第三方站点 Base URL 或计费/令牌组信息。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{}

修改于 2026-09-17 10:51:03

提交视频任务（通用格式）

下载视频