查询任务状态

GET

https://www.xinglianapi.com/v1/videos/{task_id}

根据任务 ID 查询视频生成任务的状态、进度与结果。

· 实际请求路径：/v1/videos/{task_id} 或 /v1/video/generations/{task_id}（等价）
· 建议每 10–15 秒轮询一次
· status 为 completed 时从 metadata.url 取视频地址；为 failed 时看 error.code / error.message
· 只能查询本令牌所属账号创建的任务

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

查询成功

Bodyapplication/json

示例

创建后首次查询生成中已完成失败

{
    "id": "task_V6ps6LPH5TGal801dITiA1ZlqhkKwSPX",
    "task_id": "task_V6ps6LPH5TGal801dITiA1ZlqhkKwSPX",
    "object": "video",
    "model": "doubao-seedance-2-0-fast-260128",
    "status": "unknown",
    "progress": 0,
    "created_at": 1791967944,
    "completed_at": 1791967944,
    "metadata": {
        "url": ""
    }
}

🟠400

🟠401

修改于 2026-10-14 10:04:44

创建视频任务

拉取视频流(代理)