# Images

The OpenAPI 3.1 document is the full description, including schemas:

https://router.inference.ai.exchange/v1/openapi.json

## `POST /v1/images/generations`

Buy images at auction, in the OpenAI images format.

Send `model` and `prompt`. Only a deployment registered to produce images
can win. The price is per image, so the cap is exactly the charge. The
`exchange` block of the response shows what the exchange bought and the
charge.

Reference inputs are `input_references` (images, audio, video and files). Only an offer that declared each input kind, within its limits,
can win. The exchange refuses the request before dispatch when none did. It
never sends the request to a chat model, which would answer with text.

With `stream: true`, the answer is a stream of server-sent events: see
`stream` in the request. The exchange sends the events when the job ends.