# Lyria (áudio na nuvem)

> Música do Google Lyria 3 na nuvem: clipes de 30 segundos, instrumentais ou com vocais, a partir de uma descrição em texto, para temas de menu de jogo, esboços de música de fase e bases de trailer. Usa a sua cota.

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

## Instalar

Com o CLI gamedev, na pasta do projeto:

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

No app desktop: abra a janela Packages (o ícone de pacote na barra de status), selecione **Browse**, busque `aigd.cloud-lyria` 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.4 | 2026-11-22 | `>=0.25.11` | mais recente |
| 0.1.3 | 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
# Lyria — áudio na nuvem (`aigd.cloud-lyria`)

O modelo de música Lyria 3 do Google na nuvem, executado pelo agente do AI Game Dev. Ele cria clipes de música de 30 segundos, instrumentais ou com vocais, a partir de uma descrição em texto de até 2000 caracteres. Ideal para temas de menu, esboços de música de fase e de bioma, stingers e bases de trailer. Usa a cota do seu plano do AI Game Dev; não é preciso conta do Google nem chave de API.

## O que você pode fazer

- Esboçar um tema para um menu, uma fase, um bioma ou uma luta contra chefe.
- Experimentar vários climas para a mesma cena (calmo, tenso, triunfante) e comparar.
- Criar uma base musical de 30 segundos para um trailer, um vídeo de página da loja ou um clipe para redes sociais.
- Descrever gênero, clima, instrumentos e andamento no prompt para orientar o resultado.

## Exemplos de pedidos

- "Faça uma faixa Lyria de 30 segundos para o menu principal: fantasia orquestral, esperançosa, com construção lenta."
- "Gere três versões com Lyria do tema da fase do deserto: oud e percussão, andamento médio, cada uma com um clima diferente."
- "Faça uma faixa synthwave tensa para a sequência de perseguição com o Lyria."

## Variantes

| Variante | Nome | Produz | Limites | Unidade de estimativa |
|---|---|---|---|---|
| `lyria-3` | Lyria 3 | Música | 30 s; prompt de até 2000 caracteres | por clipe |

Cada clipe tem 30 segundos. Ele não usa seed. A ferramenta de áudio do app não aceita letras separadas para música na nuvem: descreva o que você quer no prompt.

Para peças mais longas, o [ACE-Step](https://ai-game.dev/packages/aigd.cloud-ace-step) cria até 240 s na nuvem.

## Como funciona

Funciona por meio da [Geração na nuvem](https://ai-game.dev/packages/aigd.cloud-media) (`aigd.cloud-media`, ativada 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 a cada uma). As estimativas são uma porcentagem da sua cota por clipe, e uma tarefa que falha não conta na sua cota. Se o seu plano pode usá-lo vem da sua conta (a aba Modelos, `audio_list_models`); uma variante que o 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.lyria`.

As variantes, os modos e os limites são o catálogo do servidor (`aigd.cloud.lyria` 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 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 é somente dados (sem código), Apache-2.0.
````
