# Hailuo（云端视频）

> MiniMax Hailuo H3 Max 云端视频：物理与镜头运动表现强，适合游戏预告片和动作镜头，可由文本、首帧图像或首尾帧生成，时长 5 或 10 s，最高 1080p，无声。消耗你的额度。

- ID: `aigd.cloud-hailuo`
- 来源: 官方 (第一方 `aigd.*`)
- 分类: 视频
- 发布者: AI Game Dev (`aigd`), 已验证
- 最新版本: 0.1.3 (发布于 2026-11-22)
- 许可证: SEE LICENSE IN README.md
- 需要 AI Game Dev 应用: `>=0.25.11`
- 原生代码: 否
- 评分: 暂无评分
- HTML 页面: https://ai-game.dev/zh-hans/packages/aigd.cloud-hailuo

## 安装

使用 gamedev CLI，在项目文件夹中运行：

```bash
gamedev pkg add aigd.cloud-hailuo
```

在桌面应用中：打开 Packages 窗口（状态栏中的包图标），选择 **Browse**，搜索 `aigd.cloud-hailuo`，然后点击 **Add to Project**。更多：https://ai-game.dev/docs/wiki/app/packages

## 版本

| 版本 | 发布时间 | 需要应用 | 备注 |
|---|---|---|---|
| 0.1.3 | 2026-11-22 | `>=0.25.11` | 最新 |
| 0.1.2 | 2026-11-06 | `>=0.25.11` | - |
| 0.1.1 | 2026-11-01 | `>=0.25.11` | - |

## 描述

````markdown
# Hailuo——云端视频（`aigd.cloud-hailuo`）

MiniMax 的 Hailuo H3 Max 视频模型，由 AI Game Dev 智能体在云端运行。其目录条目强调强劲的物理效果和镜头运动；它能根据提示词、首帧图像或首尾帧生成无声短片，最高 1080p。适合预告片和过场动画草稿中的动作节拍、破坏场面、车辆和镜头运动，声音需另行添加。消耗你的 AI Game Dev 套餐额度；无需 MiniMax 账号。

## 你可以做什么

- 为注重运动和物理效果的动作镜头打草稿：爆炸、坠落的碎片、飞溅的水花、车辆。
- 在场景或一张主视觉图上规划镜头运动（环绕、推拉镜头、穿越飞行）。
- 让截图或概念图动起来（图生视频），或在两帧之间过渡。
- 除了 16:9 和 9:16，还能制作用于商店页面的方形（1:1）短片。

## 示例请求

- “用 Hailuo 生成一段 10 秒的镜头：石桥坍塌坠入河中，镜头横向跟拍。”
- “用 Hailuo 让 `Assets/Art/racetrack.png` 动起来：一台无人机低空掠过赛道，1080p。”
- “用 Hailuo 从 `frames/tower-intact.png` 到 `frames/tower-ruined.png` 生成一段短片。”

## 变体

| 变体 | 名称 | 模式 | 时长 | 分辨率 | 声音 |
|---|---|---|---|---|---|
| `hailuo-h3-max` | H3 Max | txt2vid, img2vid, first_last_frame | 5, 10 s | 480p, 768p, 1080p | 无 |

宽高比 16:9、9:16 和 1:1，24 fps，默认时长 5 s，默认分辨率 768p。它可以接收种子（相同的种子和提示词可得到可重复的结果），但不支持负面提示词。短片没有声音：用 [ElevenLabs](https://ai-game.dev/packages/aigd.cloud-elevenlabs) 添加音效，或用 [Lyria](https://ai-game.dev/packages/aigd.cloud-lyria) 添加音乐。

模式：**txt2vid** 根据文本生成短片，**img2vid** 从你的图像开始生成，**first_last_frame** 从首帧图像过渡到末帧图像。

## 运行方式

通过 [云端生成](https://ai-game.dev/packages/aigd.cloud-media)（`aigd.cloud-media`，在每个对话中默认开启）运行：当任务合适或你点名时，智能体会选用这个模型。在对话生成预算内的任务会直接运行、不再询问（*每次操作前询问* 则会逐个询问）。预估值为每秒视频占你额度的百分比，失败的任务不计入额度。你的套餐能否使用它取决于你的账户（模型标签页，`video_list_models`）；套餐无法使用的变体会显示为锁定状态。短片会以 MP4 保存到你的项目中，绝不会覆盖已有文件。

服务器 id（`/api/media` 的 `package_id`，即其媒体模型 id）：`aigd.cloud.hailuo`。

变体、模式和限制来自服务器目录（capabilities v2 中的 `aigd.cloud.hailuo`；`packages/core/test/cloud-media-manifests.test.ts` 让本包与其保持一致）。服务器只有在提供方路由和额度使用都通过验证后才会运行某个变体；计划中的变体会列为“即将推出”。

## 许可

模型：专有。生成的短片归你使用，但须遵守该变体提供方的条款。本包仅为数据（不含代码），Apache-2.0。
````
