API Reference
Overview
Endpoints and conventions for the asynchronous image API.
Base URL
https://api.seedrouter.aiUse 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.