Video generation models

Openference exposes video models on POST /v1/videos with polling via GET /v1/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

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:

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 and Common errors for the full list.