查询任务状态

国内端点

https://api.qnaigc.com

GET

/queue/byteplus/seedance-2.0/fast/requests/{request_id}/status

轮询任务状态。

处理中：HTTP 202，status 为 IN_QUEUE 或 IN_PROGRESS

完成/失败：HTTP 200，status 为 COMPLETED，失败时 detail 字段包含错误信息

建议轮询间隔：2～5 秒

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

返回响应

🟢200

application/json

任务已完成（成功或失败）

Bodyapplication/json

🟢202

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://api.qnaigc.com/queue/byteplus/seedance-2.0/fast/requests//status' \
--header 'Authorization: Bearer <token>'

响应示例

200 - 成功完成

{
    "status": "COMPLETED",
    "request_id": "qvideo-abc123",
    "response_url": "https://api.aitoken.com/queue/byteplus/seedance-2.0/fast/requests/qvideo-abc123",
    "status_url": "https://api.aitoken.com/queue/byteplus/seedance-2.0/fast/requests/qvideo-abc123/status",
    "queue_position": 0,
    "logs": [],
    "metrics": {
        "inference_time": 18.5
    },
    "result": {
        "video": {
            "url": "https://cdn.example.com/output/video.mp4",
            "content_type": "video/mp4",
            "duration": 5
        }
    }
}

修改于 2026-06-12 07:18:01

文生视频

图生视频（首帧/首尾帧）