Source: https://01router.com/docs/models/seedream-5.0-pro/images
Base URL: https://01router.com/api/v1

# Seedream 5.0 Pro · OpenAI-compatible images

POST /images/generations accepts the OpenAI images API, so the OpenAI SDKs, LobeChat, Cherry Studio, Dify and n8n can use every image model here. size maps to the closest aspect_ratio, n to num_images, and any model parameter can be passed as an extra field. It waits up to ~110s; a slower task returns 504 with its id to poll.

`POST /api/v1/images/generations`

Bearer API key

## Input parameters

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| model | string | yes | Model slug from the catalog. Project keys may use a project-specific model slug. | options: [   "seedream-5.0-pro" ] |
| prompt | string | yes | Text describing the requested image. Required and non-empty. |  |
| provider | string | no | Optional provider slug. Omit for automatic routing; project settings may pin the provider. |  |
| project | string | no | Optional project ID. Use its published model catalog and routing configuration. |  |
| size | string | no | Width x height, such as 1024x1024, or auto. Maps to the nearest supported aspect ratio when needed. |  |
| n | integer | no | Positive integer, default 1. Multiple images require the model to support num_images. | default: 1; min: 1 |
| response_format | string | no | url (default) or b64_json. If base64 conversion fails or exceeds the size limit, that item falls back to a URL. | default: "url"; options: [   "url",   "b64_json" ] |
| image_urls | string<uri>[] | no | Optional — switches to image editing | maxItems: 10 |
| aspect_ratio | enum | no |  | default: "1:1"; options: [   "1:1",   "16:9",   "9:16",   "4:3",   "3:4",   "3:2",   "2:3",   "21:9" ] |
| resolution | enum | no |  | default: "1K"; options: [   "1K",   "2K" ] |
| num_images | integer | no |  | default: 1; min: 1; max: 4 |

## Response fields

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| created | integer | — | Unix timestamp in seconds. |  |
| data | array | — | Each item has url or b64_json depending on response_format and conversion availability. |  |
| id | string | — | Generation ID returned by the create request. |  |
| model | string | — | Model slug from the catalog. Project keys may use a project-specific model slug. |  |
| credits | number | — | Credits charged for this generation; zero after a refund. |  |

## cURL

```bash
curl 'https://01router.com/api/v1/images/generations' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5.0-pro",
  "prompt": "A cinematic landscape at sunrise.",
  "aspect_ratio": "1:1",
  "resolution": "1K",
  "num_images": 1
}'
```

## 200 · application/json

```json
{
  "created": 1792915200,
  "data": [
    {
      "url": "https://example.com/result.png"
    }
  ],
  "id": "gen_example",
  "model": "seedream-5.0-pro",
  "credits": 10
}
```

## Usage notes

- Poll at intervals of at least 3 seconds. A 504 from the synchronous image endpoint means the task may still be running: poll its error.id instead of submitting it again.
- For /generations and /quote, put these parameters inside input. For /images/generations, put them at the top level. Chat parameters go at the top level of /chat/completions.