# Kokoro (áudio na nuvem)

> Kokoro na nuvem: um modelo aberto de fala em inglês americano com 20 vozes, que consome pouco da sua cota, para diálogos provisórios e de rascunho no jogo. Usa sua cota; o mesmo modelo também roda localmente.

- Id: `aigd.cloud-kokoro`
- Origem: Oficial (de primeira parte `aigd.*`)
- Categoria: Áudio
- Publicador: AI Game Dev (`aigd`), verificado
- Versão mais recente: 0.1.3 (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-kokoro

## Instalar

Com o CLI gamedev, na pasta do projeto:

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

No app desktop: abra a janela Packages (o ícone de pacote na barra de status), selecione **Browse**, busque `aigd.cloud-kokoro` 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.3 | 2026-11-22 | `>=0.25.11` | mais recente |
| 0.1.2 | 2026-11-06 | `>=0.25.11` | - |
| 0.1.1 | 2026-11-01 | `>=0.25.11` | - |

## Descrição

````markdown
# Kokoro — áudio na nuvem (`aigd.cloud-kokoro`)

O modelo aberto de fala Kokoro, da hexgrad, na nuvem, executado pelo agente do AI Game Developer: uma voz aberta que consome pouco da sua cota, para diálogos provisórios e de rascunho. Ele lê texto em inglês americano com uma das 20 vozes, até 5000 caracteres por requisição. Ideal para dar voz a um protótipo, a uma vertical slice ou a uma leitura de roteiro antes do trabalho final de voz. Usa a cota do seu plano do AI Game Dev; o mesmo modelo também roda localmente com o [pacote Kokoro 82M](https://ai-game.dev/packages/aigd.tts-kokoro).

## O que você pode fazer

- Dar voz a cada fala de um protótipo para que os playtesters ouçam o diálogo.
- Ler um roteiro em voz alta para conferir o ritmo e a duração antes da gravação ou das vozes finais.
- Dar a cada NPC sua própria voz entre 20 vozes em inglês americano.
- Criar narração de tutorial e prompts de voz de UI temporários.

## Exemplos de requisições

- "Dê voz a todas as falas do tutorial em `Docs/tutorial-script.md` com Kokoro, voz af_heart."
- "Leia estas falas curtas do guarda com Kokoro, voz am_onyx."
- "Crie diálogos de rascunho para os três aldeões com vozes diferentes do Kokoro."

## Variantes

| Variante | Nome | Gera | Limites | Unidade de estimativa |
|---|---|---|---|---|
| `kokoro-american-english` | Inglês americano | Fala | 20 vozes, até 5000 caracteres | por 1000 caracteres |

Vozes: af_heart (padrão), 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. As vozes `af_` são vozes femininas em inglês americano e as vozes `am_` são vozes masculinas em inglês americano. Não usa seed.

O Kokoro está na faixa de uso mais baixa dos modelos de fala na nuvem; para diálogos finais, o [ElevenLabs](https://ai-game.dev/packages/aigd.cloud-elevenlabs) tem faixas de qualidade mais altas. Para falar as falas no seu próprio computador, use o pacote local [Kokoro 82M](https://ai-game.dev/packages/aigd.tts-kokoro), que não consome nada da sua cota.

## Como funciona

Roda pelo [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 (*Ask before each operation* pergunta por cada uma). As estimativas são uma porcentagem da sua cota, e uma tarefa com falha não conta na sua cota. Se o seu plano pode usá-lo vem da sua conta (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`, seu id de modelo de mídia): `aigd.cloud.kokoro`.

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

## Licença

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