MiniMax · Video

Hermes Agent x Hailuo

Hailuo is MiniMax's video model, known for accurate physics and motion fidelity at native 1080p. Through RunAPI, standard and pro variants share a single key.

6 variants from $0.50 / call Commercial OK
Get API Key View Hermes Agent Docs

Prerequisite: npx runapi mcp install

Prompt

Prompt models

Use hailuo-02-image-to-video-pro when it matches the task: 1080p image-anchored video; image sets first frame.

You have access to RunAPI task tools for Hailuo.

Available Hailuo models:
- hailuo-02-image-to-video-pro: 1080p image-anchored video; image sets first frame
  endpoints: /api/v1/hailuo/image_to_video
  request fields: model, prompt, first_frame_image_url
- hailuo-02-image-to-video-standard: Up to 768p image-anchored video; budget tier
  endpoints: /api/v1/hailuo/image_to_video
  request fields: model, prompt, first_frame_image_url
- hailuo-02-text-to-video-pro: 1080p native text-to-video output
  endpoints: /api/v1/hailuo/text_to_video
  request fields: model, prompt
- hailuo-02-text-to-video-standard: Up to 768p text-to-video; budget tier
  endpoints: /api/v1/hailuo/text_to_video
  request fields: model, prompt
- hailuo-2.3-image-to-video-pro: Improved body motion, micro-expressions, anime/illustration styles
  endpoints: /api/v1/hailuo/image_to_video
  request fields: model, prompt, first_frame_image_url
- hailuo-2.3-image-to-video-standard: Same 2.3 motion improvements at lower resolution and cost
  endpoints: /api/v1/hailuo/image_to_video
  request fields: model, prompt, first_frame_image_url

Use the model ID and endpoint that match the user's request.
Example prompt: Generate a 6-second clip of a glass marble rolling across a wooden desk and falling off the edge.
/api/v1/hailuo/image_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/hailuo/image_to_video and save the returned Task id.
GET /api/v1/hailuo/image_to_video/<task-id> until status is completed or failed.
Verify the completed response contains the endpoint-specific output documented in the API reference.
/api/v1/hailuo/text_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/hailuo/text_to_video and save the returned Task id.
GET /api/v1/hailuo/text_to_video/<task-id> until status is completed or failed.
Verify the completed response contains the endpoint-specific output documented in the API reference.

Public Versions and Endpoints

Model ID Endpoints Price Catalog
hailuo-02-image-to-video-pro
/api/v1/hailuo/image_to_video
$0.57 / call Model detail
hailuo-02-image-to-video-standard
/api/v1/hailuo/image_to_video
$0.50 / call Model detail
hailuo-02-text-to-video-pro
/api/v1/hailuo/text_to_video
$0.57 / call Model detail
hailuo-02-text-to-video-standard
/api/v1/hailuo/text_to_video
$0.50 / call Model detail
hailuo-2.3-image-to-video-pro
/api/v1/hailuo/image_to_video
$0.90 / call Model detail
hailuo-2.3-image-to-video-standard
/api/v1/hailuo/image_to_video
$0.50 / call Model detail

Verify

Poll until the task reaches a terminal status

Select <model-id> to generate verification commands.

Configuration

Guide endpoint: <endpoint>

Select <model-id> to generate a request with the endpoint's public input contract.
How it works

Get Started in 3 Steps

  1. Choose a model ID

    Select a public catalog model ID and review its endpoint and current starting price.

  2. Configure RunAPI

    Set RUNAPI_API_KEY before making the endpoint request.

  3. Verify the result

    For asynchronous endpoints, poll the same endpoint until the Task reaches a terminal status.

What to Build with Hermes Agent + Hailuo

  • Faceless YouTube channel content

    Generate establishing shots and visual sequences for faceless YouTube channels with fast turnaround and consistent output.

  • Product and e-commerce clips

    Create product showcase videos with realistic physics, such as liquids pouring, fabrics draping, and objects rotating.

  • Establishing shots and B-roll

    Generate background footage and transition clips for longer projects, with reliable environments, atmosphere, and camera movement.

Why Use Hailuo Through RunAPI + Hermes Agent

  • 6 variants, one API key

    Use one RunAPI connection to choose among the live model variants without changing your integration.

  • Clear usage pricing

    See current catalog pricing before you send a request, with no subscription or minimum spend required.

  • Automatic task workflows

    Submit, poll, and collect asynchronous results through a consistent task workflow without writing manual polling code.

Hermes Agent + Hailuo Questions

Can I use Hailuo in Hermes Agent?

Yes. Configure RunAPI as a provider in Hermes Agent, then call the Hailuo endpoint and version shown on this page. The same RunAPI API key handles chat and video generation.

How does Hermes Agent wait for a Hailuo video?

Hailuo is asynchronous. The API returns a task ID immediately, and your Hermes Agent workflow polls the task status or provides a callback URL.

How do I avoid wasting balance while testing prompts?

Start with a lower-cost tier and shorter durations while you refine the prompt, then switch to a higher tier for the final generation.

Which model ID should I use?

Choose a public model ID from the version table. Each ID exposes the endpoints shown for that version.

Does this guide configure a chat model?

No. This Model Line uses the endpoint workflow shown here and is not presented as an agent chat model.

Start using Hailuo with Hermes Agent

Get API Key Read Quickstart

Building with a team?

We're here to help with enterprise setup, integrations, and technical questions.

Contact Us