获取视频生成任务状态

GET

/v1/video/generations/{task_id}

查询视频生成任务的状态和结果。

任务状态使用内部任务状态值：NOT_START 未启动、SUBMITTED 队列中、QUEUED 排队中、IN_PROGRESS 执行中、SUCCESS 成功、FAILURE 失败。

日志关联：该接口用于查询任务状态，不代表消耗明细。视频生成消耗明细请使用 task_id 查询日志；同一个 task_id 最多对应预扣费和后续补扣费/退费两条使用明细。

请求参数

Path 参数

Header 参数

返回响应

🟢200成功

application/json

成功获取任务状态

Headers

Bodyapplication/json

🟠404记录不存在

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://tk.wxdatas.cn/v1/video/generations/abcd1234efgh' \
--header 'Authorization: Bearer sk-xxxxxx'

响应示例

200 - 示例 1

{
    "code": "success",
    "message": "",
    "data": {
        "task_id": "task_cmKs5YPqLFIpEAXFFhn0emR45VFJMqSK",
        "action": "generate",
        "status": "NOT_START",
        "quota": 5935731,
        "result_url": "https://example.com/video.mp4",
        "submit_time": 1782094592,
        "start_time": 1782094593,
        "finish_time": 1782097341,
        "progress": "100%",
        "resolution": "1080P",
        "seconds": 5,
        "completion_tokens": 245025,
        "fail_reason": ""
    }
}

修改于 2026-07-27 00:40:26

创建视频生成任务

视频生成任务回调通知