> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openference.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Video generation models

> Agnes Video 2.5 Flash on POST /v1/videos.

# Video generation models

Openference exposes video models on [POST /v1/videos](/api-reference/videos) with polling via [GET /v1/videos/{video_id}](/api-reference/videos).

Use the model ids below in your request body. Aliases are also accepted (e.g. `agnes-video-2.5-flash` → `Agnes-Video-2.5-Flash`).

***

## Agnes Video 2.5 Flash (`Agnes-Video-2.5-Flash`)

**Task:** text-to-video, keyframe control, image/audio reference\
**Output:** 720P MP4, 4–12 seconds

| Parameter                    | Default  | Notes                                        |
| ---------------------------- | -------- | -------------------------------------------- |
| `prompt`                     | —        | Required                                     |
| `mode`                       | —        | Required: `text`, `keyframe`, or `reference` |
| `seconds`                    | `"5"`    | String `"4"`–`"12"`                          |
| `size`                       | `"720P"` | Only `720P` is supported                     |
| `aspect_ratio`               | `16:9`   | `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`  |
| `first_frame` / `last_frame` | —        | Keyframe mode (public image URLs)            |
| `images`                     | —        | Reference mode, max 5 URLs                   |
| `audios`                     | —        | Reference mode, max 3 URLs                   |

### Text-to-video example

```bash theme={null}
curl https://api.openference.com/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Agnes-Video-2.5-Flash",
    "prompt": "A poor boy in tattered clothes sits on a curb, then the scene transitions to the same man in an elegant suit entering a glass tower at sunset",
    "mode": "text",
    "seconds": "5",
    "size": "720P",
    "aspect_ratio": "16:9"
  }'
```

Save `video_id` from the response, then poll:

```bash theme={null}
curl "https://api.openference.com/v1/videos/VIDEO_ID?model=Agnes-Video-2.5-Flash" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

***

## Errors

| HTTP | Code                         | Meaning                                 |
| ---- | ---------------------------- | --------------------------------------- |
| 400  | `invalid_mode`               | Missing or unsupported `mode`           |
| 400  | `invalid_size`               | Size must be `720P`                     |
| 429  | `video_daily_limit_exceeded` | Account daily video seconds cap reached |

See [POST /v1/videos](/api-reference/videos) and [Common errors](/troubleshooting/common-errors) for the full list.