# Kokoro（雲端音訊）

> 雲端版 Kokoro：一款開放的美式英語語音模型，提供 20 種音色，額度消耗低，適合暫代與草稿性質的遊戲對白。會使用你的額度；同一個模型也能在本機執行。

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

## 安裝

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

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

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

由 AI Game Dev 代理程式在雲端執行的 hexgrad 開放 Kokoro 語音模型：一款額度消耗低的開放語音，適合暫代與草稿對白。它會以 20 種音色之一朗讀美式英語文字，每次請求最多 5000 個字元。很適合為原型、垂直切片，或正式配音前的劇本試讀配上語音。會使用你 AI Game Dev 方案的額度；同一個模型也能透過 [Kokoro 82M 套件](https://ai-game.dev/packages/aigd.tts-kokoro) 在本機執行。

## 你可以做什麼

- 為原型的每一句台詞配音，讓測試玩家能聽見對白。
- 在錄音或正式配音之前，把劇本朗讀出來，檢查節奏與長度。
- 從 20 種美式英語音色中，為每個 NPC 指定專屬音色。
- 製作臨時的新手教學旁白與 UI 語音提示。

## 範例請求

- 「用 Kokoro、音色 af_heart，為 `Docs/tutorial-script.md` 裡所有教學台詞配音。」
- 「用 Kokoro、音色 am_onyx，朗讀這些守衛的短喊話。」
- 「用不同的 Kokoro 音色，為三位村民製作草稿對白。」

## 變體

| 變體 | 名稱 | 產出 | 限制 | 預估單位 |
|---|---|---|---|---|
| `kokoro-american-english` | 美式英語 | 語音 | 20 種音色，最多 5000 個字元 | 每 1000 個字元 |

音色：af_heart（預設）、af_alloy、af_aoede、af_bella、af_jessica、af_kore、af_nicole、af_nova、af_river、af_sarah、af_sky、am_adam、am_echo、am_eric、am_fenrir、am_liam、am_michael、am_onyx、am_puck、am_santa。`af_` 音色是美式英語女聲，`am_` 音色是美式英語男聲。不需要種子。

Kokoro 屬於雲端語音模型中用量最低的等級；若是最終對白，[ElevenLabs](https://ai-game.dev/packages/aigd.cloud-elevenlabs) 有品質更高的等級。若想改在自己的電腦上朗讀台詞，請使用本機的 [Kokoro 82M](https://ai-game.dev/packages/aigd.tts-kokoro) 套件，它完全不會用到你的額度。

## 運作方式

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

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

變體、模式與限制都來自伺服器的目錄（capabilities v2 中的 `aigd.cloud.kokoro`；`packages/core/test/cloud-media-manifests.test.ts` 會讓這個套件與目錄保持一致）。伺服器只有在變體的供應商路由與額度用量都驗證通過後，才會執行該變體；規劃中的變體會標示為「Coming soon」。

## 授權

模型：Apache-2.0（開放權重）。生成的音訊可依該變體供應商的條款供你使用。本套件僅含資料（不含程式碼），Apache-2.0。
````
