# ElevenLabs (audio en la nube)

> ElevenLabs en la nube para el audio del juego: habla con 21 voces (v4 Turbo y Eleven v4) para diálogos y narración, y efectos de sonido a partir de una descripción, de 1 a 30 s; música próximamente. Consume tu cuota.

- Id: `aigd.cloud-elevenlabs`
- Origen: Oficial (propio `aigd.*`)
- Categoría: Audio
- Editor: AI Game Dev (`aigd`), verificado
- Última versión: 0.1.5 (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-elevenlabs

## Instalar

Con la CLI gamedev, en la carpeta del proyecto:

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

En la app de escritorio: abre la ventana Packages (el icono de paquete en la barra de estado), selecciona **Browse**, busca `aigd.cloud-elevenlabs` 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.5 | 2026-11-22 | `>=0.25.11` | la más reciente |
| 0.1.4 | 2026-11-18 | `>=0.25.11` | - |
| 0.1.2 | 2026-11-06 | `>=0.25.11` | - |
| 0.1.1 | 2026-11-01 | `>=0.25.11` | - |

## Descripción

````markdown
# ElevenLabs — audio en la nube (`aigd.cloud-elevenlabs`)

ElevenLabs en la nube, gestionado por el agente de AI Game Dev: voces y efectos de sonido para el audio del juego, con música próximamente. Dos variantes de habla leen tus líneas en una de 21 voces, y Sound Effects 3 crea efectos a partir de una descripción, de 1 a 30 segundos. Ideal para diálogos, narración, barks, sonidos de UI y ambiente en prototipos y builds. Consume la cuota de tu plan de AI Game Dev; no necesitas cuenta ni clave de API de ElevenLabs.

## Qué puedes hacer

- Poner voz al diálogo de los PNJ, al texto de misiones, a los tutoriales y a la narración.
- Crear barks provisionales o definitivos («¡Recargando!», «¡Por aquí!») para las pruebas de juego.
- Generar efectos de sonido para UI, armas, pasos, puertas, magia y ambiente.
- Elegir una voz por personaje entre 21 voces con nombre.
- Music v2.5 está en la lista y llegará pronto.

## Ejemplos de peticiones

- «Pon voz a estas cinco líneas de tendero con ElevenLabs, con la voz Charlotte, y guárdalas en el proyecto».
- «Lee la narración inicial con ElevenLabs v4 y la voz George».
- «Crea un efecto de sonido de ElevenLabs de 3 segundos de una pesada puerta de madera que se abre chirriando».
- «Genera 10 segundos de ambiente de viento en una cueva con Sound Effects 3».

## Variantes

| Variante | Nombre | Crea | Límites | Unidad estimada |
|---|---|---|---|---|
| `elevenlabs-v4-turbo` | v4 Turbo | Habla | 21 voces, hasta 5000 caracteres | por cada 1000 caracteres |
| `elevenlabs-v4` | Eleven v4 | Habla | 21 voces, hasta 5000 caracteres | por cada 1000 caracteres |
| `elevenlabs-sfx-3` | Sound Effects 3 | Efectos de sonido | 1, 2, 3, 5, 10, 15, 22, 30 s; prompt de hasta 500 caracteres | por segundo generado |
| `elevenlabs-music-2-5` | Music v2.5 (próximamente) | Música | 60, 120, 180 s; prompt de hasta 2000 caracteres | por segundo generado |

Voces (ambas variantes de habla): Rachel (predeterminada), Aria, Roger, Sarah, Laura, Charlie, George, Callum, River, Liam, Charlotte, Alice, Matilda, Will, Jessica, Eric, Chris, Brian, Daniel, Lily, Bill.

Sound Effects 3 crea 3 s de forma predeterminada. v4 Turbo es la variante predeterminada de la familia. Ninguna de las variantes acepta una semilla.

### Cómo elegir

- **v4 Turbo** — la variante de habla predeterminada, con un consumo de cuota menor que Eleven v4.
- **Eleven v4** — el nivel de calidad más alto de la familia para habla; consume más cuota por cada 1000 caracteres.
- **Sound Effects 3** — cualquier sonido que no sea habla, desde un breve clic de UI hasta un ambiente de 30 segundos.
- **Music v2.5** — aún no disponible; para música ahora, consulta [Lyria](https://ai-game.dev/packages/aigd.cloud-lyria) o [ACE-Step](https://ai-game.dev/packages/aigd.cloud-ace-step).

## Cómo funciona

Funciona mediante [Cloud generation](https://ai-game.dev/packages/aigd.cloud-media) (`aigd.cloud-media`, activado 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 preguntas (*Ask before each operation* pregunta por cada uno). Las estimaciones son un porcentaje de tu cuota, y un trabajo fallido no cuenta contra tu cuota. Qué variantes puede usar tu plan depende de tu cuenta (la pestaña Models, `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 de medios): `aigd.cloud.elevenlabs`.

Las variantes, los modos y los límites son el catálogo del servidor (`aigd.cloud.elevenlabs` 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 consumo de cuota están verificados; una variante planificada aparece como «Próximamente».

## Licencia

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