# Kokoro (audio en la nube)

> Kokoro en la nube: un modelo de voz abierto de inglés estadounidense con 20 voces, que consume poco de tu cuota, para diálogos de juego provisionales y de borrador. Usa tu cuota; el mismo modelo también se ejecuta en local.

- Id: `aigd.cloud-kokoro`
- Origen: Oficial (propio `aigd.*`)
- Categoría: Audio
- Editor: AI Game Dev (`aigd`), verificado
- Última versión: 0.1.3 (publicado el 2026-11-22)
- Licencia: SEE LICENSE IN README.md
- Requiere la app AI Game Dev: `>=0.25.11`
- Código nativo: no
- Valoración: aún sin valoraciones
- Página HTML: https://ai-game.dev/es/packages/aigd.cloud-kokoro

## Instalar

Con la CLI gamedev, en la carpeta del proyecto:

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

En la app de escritorio: abre la ventana Packages (el icono de paquete en la barra de estado), selecciona **Browse**, busca `aigd.cloud-kokoro` y haz clic en **Add to Project**. Más: https://ai-game.dev/docs/wiki/app/packages

## Versiones

| Versión | Publicado | Requiere app | Notas |
|---|---|---|---|
| 0.1.3 | 2026-11-22 | `>=0.25.11` | la más reciente |
| 0.1.2 | 2026-11-06 | `>=0.25.11` | - |
| 0.1.1 | 2026-11-01 | `>=0.25.11` | - |

## Descripción

````markdown
# Kokoro — audio en la nube (`aigd.cloud-kokoro`)

El modelo de voz abierto Kokoro de hexgrad en la nube, ejecutado por el agente de AI Game Dev: una voz abierta que consume poco de tu cuota, para diálogos provisionales y de borrador. Lee texto en inglés estadounidense con una de 20 voces, hasta 5000 caracteres por solicitud. Adecuado para poner voz a un prototipo, a una vertical slice o a una lectura de guion antes del trabajo de voz final. Usa la cuota de tu plan de AI Game Dev; el mismo modelo también se ejecuta en local con el [paquete Kokoro 82M](https://ai-game.dev/packages/aigd.tts-kokoro).

## Qué puedes hacer

- Poner voz a cada línea de un prototipo para que los probadores oigan el diálogo.
- Leer un guion en voz alta para comprobar el ritmo y la extensión antes de grabar o de usar las voces finales.
- Dar a cada NPC su propia voz entre 20 voces de inglés estadounidense.
- Crear narración temporal para el tutorial y avisos de voz para la interfaz.

## Ejemplos de solicitudes

- "Pon voz a todas las líneas del tutorial en `Docs/tutorial-script.md` con Kokoro, voz af_heart."
- "Lee estas frases cortas de los guardias con Kokoro, voz am_onyx."
- "Crea diálogos de borrador para los tres aldeanos con distintas voces de Kokoro."

## Variantes

| Variante | Nombre | Genera | Límites | Unidad de estimación |
|---|---|---|---|---|
| `kokoro-american-english` | Inglés estadounidense | Voz | 20 voces, hasta 5000 caracteres | por 1000 caracteres |

Voces: af_heart (predeterminada), 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. Las voces `af_` son voces femeninas de inglés estadounidense y las voces `am_` son voces masculinas de inglés estadounidense. No usa semilla.

Kokoro está en el nivel de uso más bajo de los modelos de voz en la nube; para el diálogo final, [ElevenLabs](https://ai-game.dev/packages/aigd.cloud-elevenlabs) tiene niveles de mayor calidad. Para reproducir las líneas en tu propio ordenador, usa el paquete local [Kokoro 82M](https://ai-game.dev/packages/aigd.tts-kokoro), que no consume nada de tu cuota.

## Cómo funciona

Funciona mediante [generación en la nube](https://ai-game.dev/packages/aigd.cloud-media) (`aigd.cloud-media`, activada de forma predeterminada en todos los chats): el agente elige este modelo cuando encaja con la tarea o cuando lo nombras. Los trabajos dentro del presupuesto de generación del chat se ejecutan sin preguntar (*Preguntar antes de cada operación* pregunta por cada uno). Las estimaciones son un porcentaje de tu cuota, y un trabajo fallido no se descuenta de tu cuota. Que tu plan pueda usarlo depende de tu cuenta (la pestaña Modelos, `audio_list_models`); una variante que tu plan no puede usar se muestra bloqueada. El archivo se guarda en tu proyecto como MP3 o WAV y nunca sobrescribe un archivo existente.

Id de servidor (`package_id` de `/api/media`, su id de modelo multimedia): `aigd.cloud.kokoro`.

Las variantes, los modos y los límites son el catálogo del servidor (`aigd.cloud.kokoro` en capabilities v2; `packages/core/test/cloud-media-manifests.test.ts` mantiene este paquete igual a él). El servidor ejecuta una variante solo cuando su ruta de proveedor y su uso de cuota están verificados; una variante planificada aparece como "Próximamente".

## Licencia

Modelo: Apache-2.0 (pesos abiertos). El audio generado es tuyo para usarlo según los términos del proveedor de la variante. Este paquete es solo datos (sin código), Apache-2.0.
````
