What is the difference between Hailuo 02 and Hailuo 2.3?

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 not available in 02.

Can I set both the first and last frame of a video?

Yes, but only on Hailuo 02 image-to-video endpoints. Pass first_frame_image_url and last_frame_image_url together. Hailuo 2.3 image-to-video accepts first_frame_image_url only.

How does pro vs standard pricing work?

Hailuo 02 Pro text-to-video costs 57 cents per generation regardless of duration. Standard uses duration-based pricing — 30 cents for 6 seconds, 50 cents for 10 seconds. Image-to-video standard pricing also factors in output_resolution.

Is Hailuo async or sync?

Async. The API returns a task_id immediately. Poll the task status endpoint or set a callback_url to receive a webhook when the video is ready. Typical generation time is 60-120 seconds.

What resolution does Hailuo output?

Hailuo 02 Pro outputs native 1080p. Standard outputs at 512p or 768p depending on the output_resolution parameter. Hailuo 2.3 variants support 768p or 1080p. No post-process upscaling is applied.

OPENCLAW + HAILUO

OpenClaw で Hailuo を使う。

Hailuo は MiniMax の動画生成モデルで、正確な物理シミュレーションを伴うネイティブ 1080p 映像を生成し、6 バリアントを揃えています —— Hailuo 02 と 2.3 で、それぞれ pro と standard ティアにテキスト→動画と画像→動画のエンドポイントを備えています。OpenClaw エージェントはチャットと同じ APIキーで RunAPI 経由で呼び出します。

API キーを取得ドキュメントを読む

1つの APIキー · テキスト→動画 + 画像→動画 · 非同期タスクポーリング

Use RunAPI to generate a video with MiniMax Hailuo 02 Pro.

要件：
- 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"
}

curlコマンドをコピーしてテスト hailuo

仕組み

OpenClaw で Hailuo を使う3ステップ

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

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 パラメータ

パラメータ	型	説明
`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.

OpenClaw上のHailuoとは？

MiniMaxのHailuoはクラス最速の動画生成スピードでネイティブ1080p映像を、滑らかな動きと優れた細部保持で制作します。Hailuo 2.3を通じてアニメと風格的コンテンツ向けの専用レンダリングモードを提供します。OpenClaw agentはRunAPI経由でチャットと同じAPIキーを使って呼び出します。