# HappyHorse（雲端影片）

> 雲端執行的 HappyHorse 1.1 影片：可用提示詞、起始圖片或最多 9 張參考圖片生成角色一致的片段，長度 5 或 10 秒、解析度 720p 或 1080p、無聲，適合過場動畫與預告片中的遊戲角色。會使用你的額度。

- ID: `aigd.cloud-happyhorse`
- 來源: 官方 (第一方 `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-happyhorse

## 安裝

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

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

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

阿里巴巴的 HappyHorse 1.1 影片模型，由 AI Game Dev 代理在雲端執行。它可以用提示詞、起始圖片或最多 9 張參考圖片，生成角色一致的片段，解析度為 720p 或 1080p。適合必須在每個鏡頭之間保持一致外觀的遊戲角色：過場動畫草稿、角色亮相與預告片片段。片段無聲。會使用你 AI Game Dev 方案中的額度；不需要 Alibaba 帳號。

## 你可以做什麼

- 用角色的設定表、三視圖或肖像參考圖，讓遊戲角色動起來。
- 在過場動畫或預告片的數個鏡頭中，維持同一位主角、同一套服裝或同一隻生物。
- 讓單張主視覺圖動起來（圖片轉影片）。
- 除了 16:9 與 9:16，還能製作適合商店頁面的正方形（1:1）片段。

## 範例指令

- 「用 HappyHorse 做一段 5 秒的影片，讓這位騎士揮手，並以 `Art/knight-front.png`、`Art/knight-side.png` 和 `Art/knight-back.png` 作為參考。」
- 「用 HappyHorse 以 1080p 讓 `Assets/Art/merchant.png` 動起來：她數著金幣並微笑。」
- 「用這些參考圖片，以 HappyHorse 製作同一隻巨龍的兩個鏡頭，一個飛行、一個降落。」

## 變體

| 變體 | 名稱 | 模式 | 時長 | 解析度 | 聲音 |
|---|---|---|---|---|---|
| `happyhorse-1-1` | 1.1 | txt2vid、img2vid、ref2vid（最多 9 張參考圖） | 5, 10 s | 720p, 1080p | 無 |

畫面比例為 16:9、9:16 與 1:1，24 fps，預設長度 5 秒、預設解析度 720p。它接受種子碼（相同種子碼與提示詞可得到可重現的結果），但不支援負向提示詞。片段無聲：可用 [ElevenLabs](https://ai-game.dev/packages/aigd.cloud-elevenlabs) 加上音效，或用 [Lyria](https://ai-game.dev/packages/aigd.cloud-lyria) 加上音樂。

型錄允許最多 9 張參考圖片；應用程式的影片工具目前每項工作最多只傳送 8 張。

模式：**txt2vid** 依文字生成片段，**img2vid** 從你的圖片開始，**ref2vid** 依參考圖片生成。

## 運作方式

透過 [雲端生成](https://ai-game.dev/packages/aigd.cloud-media) 執行（`aigd.cloud-media`，在每個對話中預設開啟）：當這套模型適合任務，或你指名使用時，代理就會選用它。在對話生成預算內的工作會直接執行、不再詢問（*每次操作前詢問* 則會逐一詢問）。預估值是每秒影片佔你額度的百分比，失敗的工作不計入你的額度。你的方案能否使用，取決於你的帳號（模型分頁，`video_list_models`）；方案無法使用的變體會顯示為鎖定。片段會以 MP4 儲存到你的專案中，且絕不會覆寫現有檔案。

伺服器 id（`/api/media` 的`package_id`，即其媒體模型 id）：`aigd.cloud.happyhorse`。

變體、模式與限制都來自伺服器的型錄（capabilities v2 中的 `aigd.cloud.happyhorse`；`packages/core/test/cloud-media-manifests.test.ts` 會讓此套件與之保持一致）。伺服器只會在供應商路徑與額度用量都驗證通過後，才執行某個變體；規劃中的變體會標示為「即將推出」。

## 授權

模型：專有。生成的片段歸你所有，使用時須遵守供應商針對該變體的條款。此套件僅含資料（沒有程式碼），採用 Apache-2.0。
````
