# 查询异步生图任务状态

按 `task_id` 查询异步生图任务。`status` 取值：

- **queued**：已入队待处理
- **processing**：worker 正在调上游
- **succeeded**：完成，`result` 字段为 OpenAI 形态 `{data:[{url}]}` 响应；图片同时进入画廊
- **failed**：失败，`error` 字段为错误描述，已冻结金额自动退还

建议轮询间隔 3-5 秒。

## GET /v1/images/async/{taskId}

> 查询异步生图任务状态

按 `task_id` 查询异步生图任务。`status` 取值：

- **queued**：已入队待处理
- **processing**：worker 正在调上游
- **succeeded**：完成，`result` 字段为 OpenAI 形态 `{data:[{url}]}` 响应；图片同时进入画廊
- **failed**：失败，`error` 字段为错误描述，已冻结金额自动退还

建议轮询间隔 3-5 秒。

### Authentication

`Authorization: Bearer tr-xxx`

### Path Parameters

- **taskId** `string` **(required)**  
  任务 ID（由 `POST /v1/images/async` 返回的 `id` 字段）

### Response

- **id** `string` **(required)**  
  
- **status** ``queued` | `processing` | `succeeded` | `failed`` **(required)**  
  
- **model** `string`  
  
- **created_at** `integer`  
  
- **error** `string`  
  失败原因，仅 `status=failed` 时存在
- **result** `object`  
  
- **result.created** `integer`  
  创建时间（Unix 时间戳，秒）
- **result.data** `object[]`  
  生成的图片列表
- **result.usage** `object`  
  token 用量（按 token 计费的模型返回，如 `gpt-image-2`）

### Error Codes

- `401`: 
- `404`: 任务不存在或不属于当前用户
- `429`: