Modelos compatíveis

Atualizado em 2026-09-18 · equipe Suno-API

Modelos de geração disponíveis

As requisições usam apenas os nomes de modelo da plataforma listados abaixo.

Modelo padrão recomendado: suno-v6.

Sobre a separação de stems

A separação de stems é um recurso fixo e independente: não é preciso escolher um modelo de geração. Basta enviar a música original e o modo de separação (por exemplo two ou twelve). O número de faixas retornadas é o que a resposta informar.

O parâmetro model

Nos endpoints de geração o model normalmente é opcional:

• Omitido: usa o padrão suno-v6.
• Informado: deve ser suno-v6, suno-v6-wild ou suno-v6-mini.
• Somente os nomes de modelo da tabela acima são aceitos.

Exemplo mínimo de geração

curl -X POST https://www.suno-api.io/api/music/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "uma canção folk animada sobre o primeiro dia de primavera",
    "model": "suno-v6"
  }'

Exemplo com variante do V6

{
  "model": "suno-v6-wild",
  "description": "uma faixa eletrônica com estrutura experimental"
}

Modelos desativados

Estes modelos não aceitam mais novas requisições:

• suno-v2
• suno-v3
• suno-v3-5
• suno-v4
• suno-v4-5
• suno-v4-5-all
• suno-v4-5-plus
• suno-v5
• suno-v5-5

Músicas e tarefas antigas ainda podem exibir o model_name ou model_version antigo. Trata-se de dado histórico: não significa que o modelo antigo aceite novas requisições.

Por compatibilidade com clientes antigos, uma requisição que informe um modelo desativado é processada com o padrão atual suno-v6 em vez de ser recusada. A tarefa também registra suno-v6 e nenhum erro de "modelo indisponível" é retornado. Ainda assim, atualize os exemplos para os nomes atuais o quanto antes.

Listando modelos

O GET /v1/models deve incluir ao menos estes modelos de música:

{
  "object": "list",
  "data": [
    { "id": "suno-v6", "object": "model", "owned_by": "suno" },
    { "id": "suno-v6-wild", "object": "model", "owned_by": "suno" },
    { "id": "suno-v6-mini", "object": "model", "owned_by": "suno" }
  ]
}

A resposta também pode trazer modelos de letras, rotas de compatibilidade ou modelos internos. Não os confunda com os modelos V6 de geração de música.

Escolhendo a variante do V6

Na maioria das integrações o modelo padrão basta. As três variantes diferem na fidelidade ao prompt e na variação do resultado.

Como cada execução devolve duas faixas, um fluxo prático é rascunhar com suno-v6-mini e rodar o prompt aprovado em suno-v6 para escolher a versão a publicar.

Custo e reembolso

A cobrança é por requisição, não por modelo: cada execução custa ¥0,6 e devolve duas faixas. Gerações com falha são reembolsadas automaticamente, então uma tentativa malsucedida não consome saldo. Os downloads são ilimitados e nunca cobrados à parte.