# Hailuo（雲端影片）

> 在雲端執行的 MiniMax Hailuo H3 Max 影片模型：物理與鏡頭運動表現出色，適合遊戲預告片與動作鏡頭，可依文字、起始圖片或起始與結束影格生成，5 或 10 秒，最高 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-hant/packages/aigd.cloud-hailuo

## 安裝

在專案資料夾中，使用 gamedev CLI：

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

在桌面應用程式中：開啟「套件」視窗（狀態列上的套件圖示），選擇 **瀏覽**，搜尋 `aigd.cloud-hailuo`，然後點 **加入專案**。更多資訊：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 帳號。

## 你可以做什麼

- 製作動作與物理效果至關重要的動作鏡頭草稿：爆炸、崩落的碎屑、水花飛濺、載具。
- 在一幕場景或一張主視覺上規劃鏡頭運動（環繞、推軌、穿梭飛行）。
- 讓遊戲截圖或概念圖動起來（圖生影片），或在兩個影格之間移動。
- 製作正方形（1:1）短片用於商店頁面，另有 16:9 與 9:16。

## 範例請求

- 「用 Hailuo 做一段 10 秒的鏡頭：石橋崩塌掉進河裡，鏡頭橫向跟拍。」
- 「用 Hailuo 讓`Assets/Art/racetrack.png`動起來：無人機低空飛過賽道的鏡頭，1080p。」
- 「用`frames/tower-intact.png`到`frames/tower-ruined.png`製作一段 Hailuo 短片。」

## 變體

| 變體 | 名稱 | 模式 | 時長 | 解析度 | 聲音 |
|---|---|---|---|---|---|
| `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 秒、預設解析度 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。
````
