# Submit async image task

Submit an async image generation task. Returns a `task_id` in ~1s.
Poll `GET /v1/images/async/{taskId}` for status (up to 10 minutes).

Request body: `multipart/form-data`. Optional `image[]` field
carries reference images (repeat the same field name for
multiple, up to 10); omit for text-to-image.

Billed per image by `quality` tier. Amount is frozen on submit
and debited only when `status=succeeded`; failures / rejections /
errors refund automatically.

## POST /v1/images/async

> Submit async image task

Submit an async image generation task. Returns a `task_id` in ~1s.
Poll `GET /v1/images/async/{taskId}` for status (up to 10 minutes).

Request body: `multipart/form-data`. Optional `image[]` field
carries reference images (repeat the same field name for
multiple, up to 10); omit for text-to-image.

Billed per image by `quality` tier. Amount is frozen on submit
and debited only when `status=succeeded`; failures / rejections /
errors refund automatically.

### Authentication

`Authorization: Bearer tr-xxx`

### Request Body

Content-Type: `multipart/form-data`

- **model** `string` **(required)**  
  
- **prompt** `string` **(required)**  
  Text description (up to 32K chars)
- **size** `string`  
  
- **quality** ``low` | `medium` | `high` | `auto`` (default: `medium`)  
  
- **n** `integer` (default: `1`)  
  
- **response_format** ``url` | `b64_json``  
  Return style. Supported on Seedream (including 5.0 Pro).
- **output_format** ``png` | `jpeg``  
  Output file format. Seedream 5.0 Pro/Lite (including the 5.0 alias) support png/jpeg. Seedream 4.5/4.0 have fixed JPEG output and reject this parameter; omit it.
- **image[]** `string[]`  
  Reference image (PNG/JPEG/WebP, ≤4MB each). Up to 10 images.

### Response

- **id** `string` **(required)**  
  Async task ID (UUID), used for polling
- **request_id** `string`  
  Request ID for log / billing reconciliation
- **status** ``queued`` **(required)**  
  
- **model** `string`  
  
- **created_at** `integer`  
  Creation time, Unix seconds

### Error Codes

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