# ElevenLabs (áudio na nuvem)

> ElevenLabs na nuvem para áudio de jogo: fala em 21 vozes (v4 Turbo e Eleven v4) para diálogo e narração, e efeitos sonoros a partir de uma descrição, de 1 a 30 s; música em breve. Usa sua cota.

- Id: `aigd.cloud-elevenlabs`
- Origem: Oficial (de primeira parte `aigd.*`)
- Categoria: Áudio
- Publicador: AI Game Dev (`aigd`), verificado
- Versão mais recente: 0.1.5 (publicado em 2026-11-22)
- Licença: SEE LICENSE IN README.md
- Requer o app AI Game Dev: `>=0.25.11`
- Código nativo: não
- Avaliação: ainda sem avaliações
- Página HTML: https://ai-game.dev/pt-br/packages/aigd.cloud-elevenlabs

## Instalar

Com o CLI gamedev, na pasta do projeto:

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

No app desktop: abra a janela Packages (o ícone de pacote na barra de status), selecione **Browse**, busque `aigd.cloud-elevenlabs` e clique em **Add to Project**. Mais: https://ai-game.dev/docs/wiki/app/packages

## Versões

| Versão | Publicado | Requer o app | Observações |
|---|---|---|---|
| 0.1.5 | 2026-11-22 | `>=0.25.11` | mais recente |
| 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` | - |

## Descrição

````markdown
# ElevenLabs — áudio na nuvem (`aigd.cloud-elevenlabs`)

ElevenLabs na nuvem, executado pelo agente do AI Game Dev: vozes e efeitos sonoros para áudio de jogo, com música em breve. Duas variantes de fala leem suas falas em uma das 21 vozes, e o Sound Effects 3 cria efeitos a partir de uma descrição, com 1 a 30 segundos. Ideal para diálogos, narração, barks, sons de UI e ambiência em protótipos e builds. Usa a cota do seu plano do AI Game Dev; não é preciso conta nem chave de API do ElevenLabs.

## O que você pode fazer

- Dublar diálogos de NPCs, textos de missão, tutoriais e narração.
- Criar barks provisórios ou finais ("Recarregando!", "Estou aqui!") para playtests.
- Gerar efeitos sonoros para UI, armas, passos, portas, magia e ambiência.
- Escolher uma voz por personagem entre 21 vozes nomeadas.
- O Music v2.5 está listado e chega em breve.

## Exemplos de pedidos

- "Duble estas cinco falas de lojista com o ElevenLabs, voz Charlotte, e salve no projeto."
- "Leia a narração de abertura com o ElevenLabs v4 na voz George."
- "Crie um efeito sonoro de 3 segundos no ElevenLabs de uma porta de madeira pesada rangendo ao abrir."
- "Gere 10 segundos de ambiência de vento em uma caverna com o Sound Effects 3."

## Variantes

| Variante | Nome | O que faz | Limites | Unidade de estimativa |
|---|---|---|---|---|
| `elevenlabs-v4-turbo` | v4 Turbo | Fala | 21 vozes, até 5000 caracteres | por 1000 caracteres |
| `elevenlabs-v4` | Eleven v4 | Fala | 21 vozes, até 5000 caracteres | por 1000 caracteres |
| `elevenlabs-sfx-3` | Sound Effects 3 | Efeitos sonoros | 1, 2, 3, 5, 10, 15, 22, 30 s; prompt de até 500 caracteres | por segundo gerado |
| `elevenlabs-music-2-5` | Music v2.5 (em breve) | Música | 60, 120, 180 s; prompt de até 2000 caracteres | por segundo gerado |

Vozes (ambas as variantes de fala): Rachel (padrão), Aria, Roger, Sarah, Laura, Charlie, George, Callum, River, Liam, Charlotte, Alice, Matilda, Will, Jessica, Eric, Chris, Brian, Daniel, Lily, Bill.

O Sound Effects 3 gera 3 s por padrão. O v4 Turbo é a variante padrão da família. Nenhuma das variantes aceita seed.

### Como escolher

- **v4 Turbo** — a variante de fala padrão, com menor consumo de cota que o Eleven v4.
- **Eleven v4** — o nível de qualidade mais alto da família para fala; consome mais cota por 1000 caracteres.
- **Sound Effects 3** — qualquer som que não seja fala, de um clique curto de UI a uma ambiência de 30 segundos.
- **Music v2.5** — ainda não disponível; para música agora, veja [Lyria](https://ai-game.dev/packages/aigd.cloud-lyria) ou [ACE-Step](https://ai-game.dev/packages/aigd.cloud-ace-step).

## Como funciona

Funciona por meio de [Cloud generation](https://ai-game.dev/packages/aigd.cloud-media) (`aigd.cloud-media`, ativado por padrão em todo chat): o agente escolhe este modelo quando ele se encaixa na tarefa ou quando você o nomeia. Tarefas dentro do orçamento de geração do chat rodam sem perguntas (*Perguntar antes de cada operação* pergunta por cada uma). As estimativas são uma porcentagem da sua cota, e uma tarefa com falha não conta contra sua cota. Quais variantes seu plano pode usar vem da sua conta (a aba Models, `audio_list_models`); uma variante que seu plano não pode usar aparece bloqueada. O arquivo é salvo no seu projeto como MP3 ou WAV e nunca sobrescreve um arquivo existente.

Id do servidor (`package_id` de `/api/media`, o id do modelo de mídia): `aigd.cloud.elevenlabs`.

As variantes, modos e limites são o catálogo do servidor (`aigd.cloud.elevenlabs` em capabilities v2; `packages/core/test/cloud-media-manifests.test.ts` mantém este pacote igual a ele). O servidor executa uma variante somente depois que sua rota de provedor e seu consumo de cota são verificados; uma variante planejada aparece como "Em breve".

## Licença

Modelo: proprietário. O áudio gerado é seu para usar sob os termos do provedor para a variante. Este pacote é apenas dados (sem código), Apache-2.0.
````
