OPENCLAW + HAILUO

Use Hailuo in OpenClaw.

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. OpenClaw agents call it through RunAPI with the same API key used for chat.

one API key · text to video + image to video · async task polling
Use RunAPI to generate a video with MiniMax Hailuo 02 Pro.

Requirements:
- 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"
- Use the RUNAPI_API_KEY environment variable for 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"
}
Copy the curl command to test hailuo
HOW IT WORKS

Use Hailuo in OpenClaw in three steps

1

Configure RunAPI

Set the RUNAPI_API_KEY environment variable. If you already configured RunAPI as an OpenClaw provider for chat, the same key works for video generation — no extra setup needed.

export RUNAPI_API_KEY=runapi_xxx
2

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
3

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
PARAMETERS

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 OpenClaw?

Hailuo by MiniMax is one of the fastest video generators in its class, producing native 1080p footage with smooth believable motion and good detail retention. It handles physics simulation well -- object permanence, motion coherence, and material interactions -- and offers dedicated anime and stylized content modes through Hailuo 2.3. OpenClaw agents call it through RunAPI with the same API key used for chat.

Hailuo use cases

Short-form social content

Generate quick video clips for TikTok, Reels, or YouTube. Hailuo's fast generation speed makes it practical for producing multiple variations and picking the best one.

Explainer and marketing videos

Create explainer videos and marketing clips from text descriptions. Hailuo maintains subject consistency and handles product close-ups with realistic lighting.

Anime and stylized content

Use Hailuo 2.3 variants for anime-style or illustration-based video with dedicated rendering modes not available in other video models.

FAQ

Hailuo + OpenClaw questions

OpenClaw general setup

Not configured yet? Start with the RunAPI setup guide for OpenClaw.

OpenClaw setup guide →

Hailuo model catalog

See all Hailuo variants, pricing tiers, and API docs.

Hailuo models →

Try Hailuo in OpenClaw today.

Get a free RunAPI key, paste the prompt into OpenClaw, and start generating video with MiniMax Hailuo.