# 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-hans/packages/aigd.cloud-kokoro

## 安装

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

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

在桌面应用中：打开 Packages 窗口（状态栏中的包图标），选择 **Browse**，搜索 `aigd.cloud-kokoro`，然后点击 **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
# 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_` 开头的音色是美式英语男声。它不接受 seed。

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`，在每个聊天中默认开启）运行：当任务合适，或你点名指定时，智能体会选择这个模型。在聊天的生成预算内的任务会直接运行，不再询问（*每次操作前询问*则会逐个询问）。估算值是你额度的百分比，失败的任务不计入你的额度。你的方案能否使用它由你的账户决定（“模型”标签页，`audio_list_models`）；方案无法使用的变体会显示为锁定状态。文件以 MP3 或 WAV 保存到你的项目中，绝不会覆盖已有文件。

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

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

## 许可

模型：Apache-2.0（开放权重）。生成的音频归你使用，但须遵守该变体提供方的条款。本包仅包含数据（不含代码），采用 Apache-2.0。
````
