MiniMax · 视频

Hermes Agent x Hailuo

Hailuo 是 MiniMax 的视频模型,以精准物理和运动保真著称,原生 1080p 输出。通过 RunAPI,标准和专业变体共享一把 key。

6 variants 起价 $0.50 / 次调用 可商用

Prerequisite: npx runapi mcp install

Prompt

Prompt 模型

任务匹配时使用 hailuo-02-image-to-video-pro:1080p 图生视频;图片作为首帧。

You have access to RunAPI task tools for Hailuo.

Available Hailuo models:
- hailuo-02-image-to-video-pro: 1080p 图生视频;图片作为首帧
  endpoints: /api/v1/hailuo/image_to_video
  request fields: model, prompt, first_frame_image_url
- hailuo-02-image-to-video-standard: 最高 768p 图生视频;经济档
  endpoints: /api/v1/hailuo/image_to_video
  request fields: model, prompt, first_frame_image_url
- hailuo-02-text-to-video-pro: 1080p 原生文生视频
  endpoints: /api/v1/hailuo/text_to_video
  request fields: model, prompt
- hailuo-02-text-to-video-standard: 最高 768p 文生视频;经济档
  endpoints: /api/v1/hailuo/text_to_video
  request fields: model, prompt
- hailuo-2.3-image-to-video-pro: 改进肢体运动、微表情,新增动漫/插画风格
  endpoints: /api/v1/hailuo/image_to_video
  request fields: model, prompt, first_frame_image_url
- hailuo-2.3-image-to-video-standard: 与 2.3 Pro 相同运动改进,更低分辨率和成本
  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: 生成一段 6 秒的玻璃弹珠在木桌上滚动并从边缘掉落的视频片段。
/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,并保存返回的 Task ID。
GET /api/v1/hailuo/image_to_video/<task-id>,直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。
/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,并保存返回的 Task ID。
GET /api/v1/hailuo/text_to_video/<task-id>,直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。

公开版本与端点

模型 ID 端点 起步价格 模型目录
hailuo-02-image-to-video-pro
/api/v1/hailuo/image_to_video
$0.57 / 次调用 模型详情
hailuo-02-image-to-video-standard
/api/v1/hailuo/image_to_video
$0.50 / 次调用 模型详情
hailuo-02-text-to-video-pro
/api/v1/hailuo/text_to_video
$0.57 / 次调用 模型详情
hailuo-02-text-to-video-standard
/api/v1/hailuo/text_to_video
$0.50 / 次调用 模型详情
hailuo-2.3-image-to-video-pro
/api/v1/hailuo/image_to_video
$0.90 / 次调用 模型详情
hailuo-2.3-image-to-video-standard
/api/v1/hailuo/image_to_video
$0.50 / 次调用 模型详情

验证

轮询,直到 Task 进入终态

选择 <model-id> 后生成验证命令。

配置

指南端点: <endpoint>

选择 <model-id> 后,按端点的公开输入契约生成请求。
使用流程

三步开始使用

  1. 选择模型 ID

    选择公开模型 ID,并查看其端点与当前起步价格。

  2. 配置 RunAPI

    调用端点前设置 RUNAPI_API_KEY。

  3. 验证结果

    对于异步端点,轮询同一端点,直到 Task 进入终态。

使用 Hermes Agent + Hailuo 可以构建什么

  • 无真人出镜的 YouTube 频道内容

    为无真人出镜的 YouTube 频道生成定场镜头和画面序列,出片快,质量稳定。

  • 商品与电商短片

    制作物理效果逼真的商品视频,例如液体倾倒、布料垂坠和物体旋转。

  • 定场镜头与空镜

    为较长的项目生成背景素材和转场片段,环境、氛围和运镜都稳定可靠。

为什么通过 RunAPI + Hermes Agent 使用 Hailuo

  • 6 个变体,一个 API 密钥

    通过一个 RunAPI 连接选择可用的模型变体,无需更改现有集成。

  • 清晰的用量价格

    发送请求前查看目录中的当前价格,无需订阅或最低消费。

  • 自动化任务流程

    通过一致的任务流程提交任务、查询状态并收集异步结果,无需编写手动轮询代码。

Hermes Agent + Hailuo 常见问题

可以在 Hermes Agent 中使用 Hailuo 吗?

可以。在 Hermes Agent 中把 RunAPI 配置为提供方,然后调用本页列出的 Hailuo 端点和版本。同一个 RunAPI API 密钥可同时用于聊天和视频生成。

Hermes Agent 如何等待 Hailuo 视频生成完成?

Hailuo 是异步的。API 会立即返回任务 ID,你的 Hermes Agent 工作流可以轮询任务状态,或提供回调 URL。

测试提示词时如何避免浪费余额?

打磨提示词阶段先用成本较低的档位和较短的时长,最终生成时再切换到更高档位。

应该使用哪个模型 ID?

从版本表选择公开模型 ID。每个 ID 可使用的端点均显示在对应行。

本指南会配置聊天模型吗?

不会。该 Model Line 使用页面所示的端点流程,不会被描述为 Agent 聊天模型。

开始在 Hermes Agent 中使用 Hailuo

需要团队接入支持?

我们可以协助团队接入、完成系统集成并解答技术问题。

联系我们