Use Hailuo in Hermes Agent.
Hailuo is MiniMax's video generation model producing native 1080p footage with accurate physics simulation across 6 variants — Hailuo 02 and 2.3, each with text-to-video and image-to-video endpoints in pro and standard tiers. Hermes Agent calls it through RunAPI using the custom:runapi provider — same key and base URL you configured for chat.
Use RunAPI to generate a video with MiniMax Hailuo 02 Pro through Hermes Agent.
Requirements:
- Use the custom:runapi provider already configured in Hermes Agent
- Call the RunAPI text_to_video endpoint at https://runapi.ai/api/v1/hailuo/text_to_video
- Set model to "hailuo-02-text-to-video-pro"
- The RUNAPI_API_KEY environment variable provides authorization
- Include a detailed prompt describing camera movement and scene
- The response is async — poll the task status endpoint until the task completes, then retrieve the video URL
curl -X POST https://runapi.ai/api/v1/hailuo/text_to_video \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "hailuo-02-text-to-video-pro",
"prompt": "A glass marble rolls across a wooden desk, catches the edge, and falls in slow motion. Camera follows the marble. Soft window light, shallow depth of field."
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "hailuo-02-text-to-video-pro"
}
Use Hailuo in Hermes Agent in three steps
Configure RunAPI
Set the RUNAPI_API_KEY environment variable. If you already added RunAPI as a custom:runapi provider in Hermes Agent for chat, the same key and base_url work for video generation — no extra configuration needed.
export RUNAPI_API_KEY=runapi_xxx
Call Hailuo text_to_video or image_to_video
Send a POST request to /api/v1/hailuo/text_to_video with model set to hailuo-02-text-to-video-pro and a scene-describing prompt. For image-anchored video, use the image_to_video endpoint with first_frame_image_url to preserve your source subject.
POST /api/v1/hailuo/text_to_video
Poll for the result
The endpoint returns a task_id immediately. Poll the task status endpoint until the status changes to completed, then retrieve the generated video URL from the response. Typical turnaround is under two minutes for pro tier.
GET /api/v1/hailuo/text_to_video/tsk_abc123
Hailuo API parameters
| Parameter | Type | Description |
|---|---|---|
model |
string |
Required. One of: hailuo-02-text-to-video-pro, hailuo-02-text-to-video-standard, hailuo-02-image-to-video-pro, hailuo-02-image-to-video-standard, hailuo-2.3-image-to-video-pro, hailuo-2.3-image-to-video-standard. |
prompt |
string |
Required. Text description of the video scene, camera movement, and lighting. |
first_frame_image_url |
string |
Required for image_to_video endpoints. URL of the source image used as the first frame. |
last_frame_image_url |
string |
Optional. URL of an image used as the last frame. Available on Hailuo 02 image-to-video only. |
duration_seconds |
integer |
Optional. Video length in seconds. Accepted values: 6 or 10. Defaults to 10 on standard, fixed on pro. |
output_resolution |
string |
Optional. Output resolution. 512p or 768p for 02 standard; 768p or 1080p for 2.3 variants. |
callback_url |
string |
Optional. Webhook URL that receives a POST when the task completes. |
What is Hailuo on Hermes Agent?
Hailuo by MiniMax delivers the fastest generation speed in its class with smooth motion coherence and strong detail retention. Through the Hermes Agent custom:runapi provider, it produces native 1080p footage from text or images, with Hailuo 2.3 adding dedicated anime and illustration rendering styles. Its speed makes it a practical choice for workflows that need multiple video variations quickly.
Hailuo use cases
Faceless YouTube channel content
Generate establishing shots and visual sequences for faceless YouTube channels. Hailuo's fast turnaround and consistent output quality make it practical for regular content production.
Product and e-commerce clips
Create product showcase videos with realistic physics -- liquids pouring, fabrics draping, objects rotating -- for listing pages and social ads.
Establishing shots and B-roll
Generate background footage and transition clips for longer video projects. Hailuo handles environment rendering, atmospheric effects, and camera movement reliably.
Hailuo + Hermes Agent questions
Yes. Configure RunAPI as a custom:runapi provider in Hermes Agent, then call the text_to_video or image_to_video endpoint with a Hailuo model slug. The same RUNAPI_API_KEY you use for chat handles video generation.
Hailuo 02 supports both text-to-video and image-to-video with first-frame and last-frame control. Hailuo 2.3 is image-to-video only but adds improved body motion, micro-expressions, and dedicated anime and illustration rendering styles.
Standard tier pricing varies by duration_seconds. For text-to-video standard, a 6-second clip costs 30 cents and a 10-second clip costs 50 cents. Image-to-video standard pricing also factors in output_resolution — a 6s 512p clip starts at 12 cents.
No. Hailuo is asynchronous — the API returns a task_id immediately. Your Hermes Agent workflow needs to poll the task status endpoint or provide a callback_url. Typical generation time is 60-120 seconds.
Only on Hailuo 02 image-to-video endpoints. Pass first_frame_image_url and last_frame_image_url together to define start and end frames. Hailuo 2.3 image-to-video accepts first_frame_image_url only.
Start with the standard tier (lower cost) and shorter durations to test your prompt. Once you find the right prompt and composition, switch to pro tier for the final generation. Use negative prompts to reduce artifacts. The standard tier is also good for A/B testing different creative directions quickly.
Yes. Hermes Agent can generate an initial clip, then pass it back to Hailuo for extension, or chain it with ElevenLabs for voiceover, building a complete video sequence in one workflow run.
Hermes Agent general setup
Not configured yet? Start with the RunAPI setup guide for Hermes Agent.
Hermes Agent setup guide →Try Hailuo in Hermes Agent today.
Get a free RunAPI key, configure the custom:runapi provider, and start generating video with MiniMax Hailuo.