# 异步生成图片

提交异步图片生成任务，立即返回 `task_id`（约 1 秒内）。通过
`GET /v1/images/async/{taskId}` 轮询状态，最长 10 分钟。

请求体 `multipart/form-data`。可选 `image[]` 字段直传参考图（同名
字段重复提交多张，最多 10 张）；不传即文生图。

计费按 `quality` 档位，提交时冻结、`status=succeeded` 时实际扣费；
失败 / 拒绝 / 错误自动退还冻结。

## POST /v1/images/async

> 异步生成图片

提交异步图片生成任务，立即返回 `task_id`（约 1 秒内）。通过
`GET /v1/images/async/{taskId}` 轮询状态，最长 10 分钟。

请求体 `multipart/form-data`。可选 `image[]` 字段直传参考图（同名
字段重复提交多张，最多 10 张）；不传即文生图。

计费按 `quality` 档位，提交时冻结、`status=succeeded` 时实际扣费；
失败 / 拒绝 / 错误自动退还冻结。

### Authentication

`Authorization: Bearer tr-xxx`

### Request Body

Content-Type: `multipart/form-data`

- **model** `string` **(required)**  
  
- **prompt** `string` **(required)**  
  图片描述（最长 32K 字符）
- **size** `string`  
  
- **quality** ``low` | `medium` | `high` | `auto`` (default: `medium`)  
  
- **n** `integer` (default: `1`)  
  
- **response_format** ``url` | `b64_json``  
  返回方式。Seedream（含 5.0 Pro）支持。
- **output_format** ``png` | `jpeg``  
  图像文件格式。Seedream（含 5.0 Pro）支持。
- **image[]** `string[]`  
  参考图（PNG/JPEG/WebP，单张 ≤4MB），最多 10 张。multipart

### Response

- **id** `string` **(required)**  
  异步任务 ID（UUID），用于后续轮询
- **request_id** `string`  
  请求 ID，跟日志/账单对账用
- **status** ``queued`` **(required)**  
  
- **model** `string`  
  
- **created_at** `integer`  
  创建时间 Unix 秒

### Error Codes

- `400`: 
- `401`: 
- `402`: 
- `429`: