# ACE-Step (áudio na nuvem)

> ACE-Step 1.5 na nuvem: geração de música aberta a partir de um prompt de estilo, de 10 s a 4 minutos, o modelo de música na nuvem mais leve da sua cota para esboçar trilhas de jogo. Usa a sua cota; o mesmo modelo também roda localmente.

- Id: `aigd.cloud-ace-step`
- 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-ace-step

## Instalar

Com o CLI gamedev, na pasta do projeto:

```bash
gamedev pkg add aigd.cloud-ace-step
```

No app desktop: abra a janela Packages (o ícone de pacote na barra de status), selecione **Browse**, busque `aigd.cloud-ace-step` 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
# ACE-Step — áudio na nuvem (`aigd.cloud-ace-step`)

O modelo de música aberto ACE-Step 1.5 da ACE Studio, na nuvem, executado pelo agente do AI Game Developer. Ele cria música a partir de um prompt de estilo, de 10 segundos até 4 minutos, e fica na faixa de uso mais baixa entre os modelos de música na nuvem, o que o torna o jeito mais leve de usar a sua cota para esboçar uma faixa. Ideal para rascunhos de música de fase, faixas para testar em uma build e peças de fundo mais longas. Usa a cota do seu plano do AI Game Developer; o mesmo modelo também roda localmente com o [pacote ACE-Step 1.5](https://ai-game.dev/packages/aigd.audio-ace-step-1-5).

## O que você pode fazer

- Esboçar música de fundo para uma fase, um hub ou um menu.
- Criar peças mais longas (até 240 segundos) para cenas de exploração e de ambiente.
- Experimentar muitos estilos e ficar com o que mais combina.
- Repetir um resultado com uma seed.

## Exemplos de pedidos

- "Faça uma faixa ACE-Step de 60 segundos para a fase da floresta: violão acústico, flauta, calma e aconchegante."
- "Gere uma peça ambiente de 2 minutos para o hub da estação espacial com o ACE-Step."
- "Faça três rascunhos ACE-Step de 30 segundos de um tema de chefe em chiptune com seeds diferentes."

## Variantes

| Variante | Nome | Gera | Limites | Unidade de estimativa |
|---|---|---|---|---|
| `ace-step-1-5` | ACE-Step 1.5 | Música | 10, 30, 60, 120, 240 s; prompt de até 500 caracteres | por segundo gerado |

A duração padrão é 30 s. Aceita uma seed (mesma seed e prompt para um resultado semelhante).

Letras: a variante na nuvem não aceita letras, então descreva o estilo (gênero, clima, instrumentos, andamento) no prompt. Para músicas com as suas próprias letras, use o pacote local [ACE-Step 1.5](https://ai-game.dev/packages/aigd.audio-ace-step-1-5) na sua GPU, que não consome nada da sua cota.

## Como funciona

Roda pela [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 por cada uma). As estimativas são uma porcentagem da sua cota por segundo gerado, 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 substitui um arquivo existente.

ID do servidor (`package_id` de `/api/media`, o id do modelo de mídia): `aigd.cloud.ace-step`.

As variantes, os modos e os limites são o catálogo do servidor (`aigd.cloud.ace-step` 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 estão verificados; uma variante planejada aparece como "Em breve".

## Licença

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