Model Guide
Agnes Video 2.5 Flash: Free AI Video for OpenClaw and Hermes
agnes-video-2.5-flash turns text or reference images into 720p video clips from 4 to 12 seconds long. Agnes currently lists generation at $0 per second as a limited-time promotion, and the model is now available for both OpenClaw and Hermes Agent instances on OpenClaw Launch.
What Is Agnes Video 2.5 Flash?
Agnes Video 2.5 Flash is the fast video-generation model in Agnes AI’s 2.5 family. It supports text-to-video, image-guided generation, and six output shapes while keeping every result at a fixed 720p tier. Generation is asynchronous: Agnes accepts the request, queues a task, and returns the finished video URL after the task completes.
It is a separate media model from the Agnes 2.5 Flash chat model. Use the chat model for conversation, coding, and tool calls; select Agnes Video 2.5 Flash in your instance’s Video dropdown when you want an MP4.
Agnes Video 2.5 Flash Specifications
| Feature | Supported value |
|---|---|
| Model ID | agnes-video-2.5-flash |
| Current price | $0 / second during the Agnes promotion |
| Resolution | 720p only |
| Duration | 4–12 seconds; 5 seconds by default |
| Aspect ratios | 21:9, 16:9, 4:3, 1:1, 3:4, and 9:16 |
| Generation modes | Text, keyframe, and reference in the direct Agnes API |
| Reference limit | Up to 5 images in direct API and Hermes reference mode |
| Outputs per request | 1 video |
The pixels depend on the requested shape: 16:9 is 1280×720, 9:16 is 720×1280, 1:1 is 720×720, 21:9 is 1680×720, 4:3 is 960×720, and 3:4 is 720×960.
Set It Up on OpenClaw Launch
- Create an Agnes key — Sign up at platform.agnes-ai.com and create an API key. Agnes keys begin with
sk-. - Save the key — Open the OpenClaw Launch API Keys page, find Agnes, paste the key, and save it. The key is encrypted at rest and applied to existing instances without a redeploy.
- Select the video model — On your instance card, open the Video dropdown and choose Agnes Video 2.5 Flash.
- Ask for a clip — Describe the subject, setting, camera motion, and format in chat. Your agent submits the task and returns the completed video in the same conversation.
Need the provider setup in more detail? Follow the OpenClaw Agnes setup guide or the Hermes Agent Agnes setup guide.
OpenClaw and Hermes Support
Both frameworks use your own Agnes key, but their video tools expose different controls. OpenClaw Launch translates each framework’s native tool shape into the strict Agnes Video 2.5 request contract.
| Capability | OpenClaw | Hermes Agent |
|---|---|---|
| Text-to-video | Yes | Yes |
| Image reference | 1 starting image | Up to 5 reference images |
| Duration | 4–12 seconds | 4–12 seconds |
| Resolution | 720p | 720p |
| Aspect ratios | 16:9 or 9:16 | All 6 Agnes ratios |
| Audio reference | Not exposed | Not exposed |
Internally, the hosted selectors use openai/agnes-video-2.5-flash for OpenClaw and agnes/agnes-video-2.5-flash for Hermes. You normally do not need to type either value; choose the labelled model in the dropdown. The bare model ID in direct Agnes API calls is agnes-video-2.5-flash.
Prompt Examples
A useful video prompt names the subject, action, setting, visual style, camera move, light, and desired orientation. Put the most important action first.
Landscape product shot
Create a 6-second 16:9 cinematic product shot of a matte-black
mechanical keyboard on a walnut desk. Slow dolly-in, warm window
light, shallow depth of field, subtle dust motes, realistic motion.Portrait social clip
Create an 8-second 9:16 video of a tiny astronaut walking through
a rain-soaked neon market at night. Low tracking camera, reflections
on the pavement, gentle handheld movement, no on-screen text.Reference-image animation
Animate this reference image for 5 seconds. Keep the character,
clothing, and background composition consistent. Add a natural blink,
a slight smile, and a slow camera push-in. Avoid face distortion.Call the Agnes API Directly
For a server-side integration, submit a task to POST /v1/videos. Keep your API key in a server environment variable; never expose it in browser code or a public repository.
curl https://apihub.agnes-ai.com/v1/videos \
-H "Authorization: Bearer $AGNES_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "agnes-video-2.5-flash",
"mode": "text",
"prompt": "A paper boat sailing through a glowing city canal",
"size": "720P",
"aspect_ratio": "16:9",
"seconds": "5",
"n": 1
}'Extract the returned video_id value (not task_id), then poll the separate status endpoint every one or two seconds until the task completes:
curl "https://apihub.agnes-ai.com/agnesapi?video_id=VIDEO_ID&model_name=agnes-video-2.5-flash" \
-H "Authorization: Bearer $AGNES_API_KEY"On a completed response, read the public MP4 URL from metadata.url and download or copy it before its hosting policy changes. Reference images must be reachable by Agnes for the full lifetime of the task. Non-empty reference video inputs are not supported by Video 2.5 Flash.
Troubleshooting
The request fails validation
- Send the exact model ID
agnes-video-2.5-flash, uppercase720P, and a string duration from"4"through"12". - Set
nto1. Multiple outputs in one request are not supported. - Use one of the six documented aspect ratios and choose the correct mode for the media you supplied.
The task stays queued
Free-tier queue time can vary. A queued task is not necessarily stuck; keep polling until it reaches a completed or failed state. OpenClaw Launch waits longer than a typical paid-provider integration because Agnes promotion traffic can be bursty.
The reference image does not work
- For the direct API, use a public HTTPS image URL that Agnes can fetch and leave it available until the task finishes.
- On OpenClaw Launch, attach the image in chat instead of asking the agent to fetch a private or expiring link.
- Hermes accepts up to five image references. OpenClaw’s shared video tool uses one starting image.
Frequently Asked Questions
Is Agnes Video 2.5 Flash permanently free?
No permanent-free guarantee has been published. Agnes currently discounts the model from its $0.025-per-second list price to $0 per second for a limited-time promotion. Check the current Agnes documentation before relying on that price at scale.
Can it generate vertical videos?
Yes. Choose 9:16 for a 720×1280 vertical result. The direct API and Hermes also support 3:4; OpenClaw’s current shared video tool exposes 9:16 for portrait video.
Does it generate audio?
The Agnes direct API documents audio-reference inputs for reference workflows, but OpenClaw Launch does not currently expose audio-reference controls for this model. Treat the hosted integration as visual video generation and add sound afterward.
How long does a video take?
There is no guaranteed completion time. Agnes processes videos asynchronously, and the promotional queue can add several minutes during busy periods. Your agent waits for the task and returns the URL when it is ready.
What's Next?
- Agnes on OpenClaw — Save your key and enable Agnes chat, image, and video models
- Agnes on Hermes Agent — Configure the same Agnes key for a Hermes instance
- Make videos with your bot — Learn the complete prompt-to-MP4 workflow
- Compare with Kling — Explore paid video models with native audio and higher-end controls