查询视频任务状态与结果

GET

/v1/videos/{id}

通过任务 ID 查询视频生成进度。id 使用创建任务响应中的 id 或 task_id。

完成后从 metadata.url 获取视频地址。

本站对外任务状态：queued → in_progress → completed / failed。上游的 processing / running / succeeded 等别名会由 new-api 适配为本站状态。

建议每 5-10 秒轮询一次，不要高频请求。

链接有效期取决于上游存储策略，建议客户端拿到后及时转存。

请求参数

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

示例

生成中生成完成生成失败

{
    "id": "task_qghsnDbtZo7FeliS4PAA1jGQsq1X1laH",
    "task_id": "task_qghsnDbtZo7FeliS4PAA1jGQsq1X1laH",
    "object": "video",
    "model": "doubao-seedance-2-0-fast-260128",
    "status": "in_progress",
    "progress": 42,
    "created_at": 1778479354
}

🟠401

🟠404

修改于 2026-06-29 05:21:56

创建视频生成任务

CreateVideoRequest