# Overview

## Base URL

```text
https://api.seedrouter.ai
```

Use HTTPS and authenticate with a Bearer API key. Requests and task responses use JSON.

## Endpoints

| Method | Path                     | Purpose                                     |
| ------ | ------------------------ | ------------------------------------------- |
| POST   | `/v1/images/generations` | Submit an image generation or editing task. |
| GET    | `/v1/tasks/{id}`         | Read the task state and its result.         |

These conventions describe the documented image task API. Consult each model's reference for supported parameters.

## Request lifecycle

Submit a request, store its returned `id`, then poll that ID until `status` is `completed` or `failed`. Submission does not return the image itself.

On completion, image URLs are in `output.data[].url`. On failure, inspect `error.code` and `error.message`. Failed tasks are not charged.

## Next steps

* [Quickstart](https://seedrouter.ai/docs/api/quickstart)
* [GPT Image 2 parameters](https://seedrouter.ai/docs/gpt-image-2#parameters)
* [Task states](https://seedrouter.ai/docs/api/tasks)