获取任务状态

GET

/v1/tasks/{task_id}

查询异步任务的执行状态和结果

实时状态更新和进度跟踪

任务完成时获取生成结果

支持多语言返回（zh/en/ko/ja）

请求参数

Path 参数

Query 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/v1/tasks/task-unified-1757156493-imcg5zqt?language' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}'

返回响应

🟢200

application/json

成功返回任务状态

Body

示例

图像生成任务示例视频生成任务示例

{
    "code": 200,
    "data": {
        "id": "task_01KA040M0HP1GJWBJYZMKX1XS1",
        "status": "completed",
        "progress": 100,
        "result": {
            "images": [
                {
                    "url": [
                        "https://...png"
                    ],
                    "expires_at": 1763174708
                }
            ]
        },
        "created": 1763088289,
        "completed": 1763088308
    }
}

🟠401

🟠429

修改于 2026-01-30 05:01:35

veo3.1/sora2 查询视频任务状态(官方格式)

Sora2 视频生成