# ImageRouter

> ImageRouter is a unified API for generating images, videos, and text with many AI models through a single OpenAI-compatible endpoint. Get an API key at https://imagerouter.io/api-keys

## Important for AI agents

- Read the docs: https://docs.imagerouter.io. Every documentation page is also available as raw Markdown by appending `/index.md` to its path (e.g. `https://docs.imagerouter.io/api-reference/image-generation/index.md`).
- Do not guess model IDs. Fetch the live list from `GET https://api.imagerouter.io/v3/models` (more in the docs). Recommended to use the *-latest alias for model name, if exists.
- Free mock test model is `test/test` (image) and `ir/test-video` (video).
- Machine-readable OpenAPI spec: https://api.imagerouter.io/.well-known/openapi.yaml
- Agent skill file (curl-based quick start): https://imagerouter.io/SKILL.md

## Common mistakes

- Using `/v1/images/generations` instead of `/v1/openai/images/generations` — add the `/openai/` segment.
- Hardcoding model names like `gpt-image-1` or `dall-e-3` — call `GET /v3/models` and use an ID returned there.