HERMES + HAILUO

在 Hermes Agent 中使用 Hailuo。

Hailuo 是 MiniMax 的视频生成模型，可生成原生 1080p 画面并精确模拟物理效果，涵盖 6 个版本 —— Hailuo 02 和 2.3，每个版本都提供 pro 和 standard 层级的文生视频与图生视频端点。Hermes Agent 通过 custom:runapi provider 调用它 —— 使用你为聊天配置的相同密钥和 base URL。

获取 API Key 阅读文档
一个 API 密钥 · 文生视频 + 图生视频 · 异步任务轮询 
Use RunAPI to generate a video with MiniMax Hailuo 02 Pro through Hermes Agent.

要求：
- 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"
}
复制 curl 命令进行测试 hailuo
工作原理

三步在 Hermes Agent 中使用 Hailuo

1

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
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
参数

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.

Hermes Agent 上的 Hailuo 是什么？

MiniMax 的 Hailuo 以同类最快的生成速度、流畅的运动连贯性和出色的细节保留著称。通过 Hermes Agent 的 custom:runapi provider，可从文本或图像生成原生 1080p 素材，Hailuo 2.3 还新增了专用的动漫和插画渲染风格。

Hailuo 使用场景

无脸 YouTube 频道内容

为无脸 YouTube 频道生成空镜和视觉序列。Hailuo 的高速交付和稳定的输出质量使其适合常规内容生产。

产品与电商短片

创作带写实物理效果的产品展示视频——液体倾倒、面料垂落、物体旋转——用于商品详情页和社交广告。

空镜与 B-roll 素材

为长视频项目生成背景素材和转场片段。Hailuo 在环境渲染、大气效果和镜头运动方面表现稳定可靠。

常见问题

Hailuo + Hermes Agent 常见问题

Hermes Agent 通用配置

尚未配置？请从 Hermes Agent 的 RunAPI 配置指南开始。

Hermes Agent 配置指南 →

Hailuo 模型目录

查看所有 Hailuo 版本、定价层级和 API 文档。

Hailuo 模型 →

立即在 Hermes Agent 中试用 Hailuo。

免费获取 RunAPI 密钥，配置 custom:runapi provider，开始使用 MiniMax Hailuo 生成视频。

浏览模型 →