# Video

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

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

## `POST /v1/videos`

Buy a video at auction, in the OpenAI video format.

Send `model` and `prompt` as JSON or `multipart/form-data`. The reply comes
when a provider accepts the job. Poll `GET /v1/videos/{video_id}`. When the
status is `completed`, download the file with
`GET /v1/videos/{video_id}/content`.

Only a deployment registered to render video can win. The price is per
second of video, so the cap is exactly the charge.

Reference inputs are `input_references` (images, audio, video and files).
Only an offer that declared each input kind can win. The exchange refuses
the request before dispatch when none did.

The start image (the `first_frame` entry, else the first image) must match the shape of the video within 1%, because an upstream crops it.
The shape is `size`, or the default size of each offer. The router reads only
the header of a linked start image.