在 OpenClaw 中使用 Hailuo。
Hailuo 是 MiniMax 的视频生成模型，可生成原生 1080p 画面并精确模拟物理效果，涵盖 6 个版本 —— Hailuo 02 和 2.3，每个版本都提供 pro 和 standard 层级的文生视频与图生视频端点。OpenClaw 智能体使用与聊天相同的 API 密钥，通过 RunAPI 调用它。
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"
}
三步在 OpenClaw 中使用 Hailuo
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 key。
Hailuo 使用场景
社交媒体短视频
为 TikTok、Reels 或 YouTube 快速生成视频片段。Hailuo 的高速生成使多版本创作并从中挑选最佳版本变得切实可行。
解说与营销视频
根据文字描述创作解说视频和营销短片。Hailuo 在保持主体一致性和产品特写写实光效方面表现出色。
动漫与风格化内容
使用 Hailuo 2.3 变体进行动漫风格或插画风格的视频创作，提供其他视频模型所没有的专用渲染模式。
Hailuo + OpenClaw 常见问题
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.
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.
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.
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.
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.