查询图片任务

轮询本接口，直到 data.status 为 SUCCESS 或 FAILURE（建议间隔 2–5 秒）。

成功时 data.data.images 含零起始 index、mime_type、字节数 size、Unix 秒 expires_at

失败原因在 data.fail_reason；不会把原始上游载荷、密钥或临时图片 URL 作为任务结果输出

仅任务创建者且使用同一把 API 密钥可查询；额度恰好耗尽的密钥仍能取回已支付的图片

任务执行最多 15 分钟，另有最多 2 分钟归档时间

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

返回响应

🟢200

application/json

任务记录（包含当前状态与已完成的结果）

Bodyapplication/json

示例

成功失败

{
    "success": true,
    "data": {
        "task_id": "task_9f2c1a7b4e",
        "platform": "openai_image",
        "action": "image_generation",
        "status": "SUCCESS",
        "model": "gpt-image-1",
        "created_at": 1792488481,
        "data": {
            "kind": "image_task",
            "images": [
                {
                    "index": 0,
                    "mime_type": "image/png",
                    "size": 1583021,
                    "expires_at": 1792747681
                }
            ],
            "expires_at": 1792747681,
            "cleaned": false
        }
    }
}

🟠400

🟠401

🟠403

🟠404

🟠410

🟠413

🟠429

🔴500

请求参数

请求示例代码

返回响应