查询任务状态

GET

https://www.xinglianapi.com/api/v3/contents/generations/tasks/{id}

查询任务状态与结果。

· 建议每 10–15 秒轮询一次，480p、4 秒的任务实测约 1–2 分钟完成
· 只能查询本令牌所属账号创建的任务
· status 为 succeeded 时从 content.video_url 取视频；failed 时看 error.code / error.message，预扣费用已全额退回
· 视频与尾帧链接 24 小时内有效，请及时转存

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.xinglianapi.com/api/v3/contents/generations/tasks/' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200

application/json

查询成功，具体状态看 status 字段

Bodyapplication/json

示例

成功失败

{
    "id": "task_vBq5nm0VrAIEDfn0og1PWzln8uC7c0tJ",
    "model": "doubao-seedance-2-0-fast-260128",
    "status": "succeeded",
    "content": {
        "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0-fast/xxxx.mp4?X-Tos-...",
        "last_frame_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0-fast/xxxx_last-frame.png?X-Tos-..."
    },
    "usage": {
        "completion_tokens": 54396,
        "total_tokens": 54396
    },
    "resolution": "480p",
    "ratio": "16:9",
    "duration": 4,
    "framespersecond": 24,
    "generate_audio": true,
    "seed": 3260,
    "created_at": 1791953162,
    "updated_at": 1791953253
}

🟠400

🟠401

修改于 2026-10-14 07:38:10

创建视频任务