> ## Documentation Index
> Fetch the complete documentation index at: https://seedanceapi.us/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Image generation

> Generate images synchronously with POST /v1/images.

`POST /v1/images` generates images synchronously. Balance is charged per generation when the request succeeds.

## Request body

```json theme={null}
{
  "model": "seedream-5.0/text-to-image",
  "prompt": "Your prompt here",
  "size": "2K",
  "image": "https://...",
  "output_format": "jpeg"
}
```

| Field           | Required           | Description                                 |
| --------------- | ------------------ | ------------------------------------------- |
| `model`         | Yes                | Model ID, e.g. `seedream-5.0/text-to-image` |
| `prompt`        | For text-to-image  | Text description                            |
| `size`          | No                 | Output size, e.g. `2K`                      |
| `image`         | For image-to-image | Source image URL                            |
| `output_format` | No                 | `jpeg` or `png`                             |

## Response (200)

```json theme={null}
{
  "id": "uuid",
  "status": "completed",
  "model": "seedream-5.0/text-to-image",
  "output_urls": ["https://..."],
  "price_usd": 0.06
}
```