LogoAI Music API
Entrar

Endpoint do modelo · POST /v2/generate

Suno v6 API

Gere músicas completas — vocais, letras e instrumentais — por um único endpoint REST assíncrono. A família chirp-v6 cobre o modelo Suno v6 principal, uma camada rápida e econômica e uma variante mais experimental, cobrada por requisição em créditos.

10–12 créditos por música · 1 USD = 100 créditos

O que a Suno v6 API oferece

A Suno v6 API permite que sua aplicação no servidor crie músicas completas a partir de um prompt de texto ou letra personalizada. Você escolhe um modelo da família chirp-v6, envia uma requisição POST e recebe um workId para a tarefa assíncrona — vocais, estrutura e instrumentação são produzidos para você.

Três modelos atuais compartilham o mesmo endpoint. O chirp-v6 é o modelo principal para lançamentos em produção. O chirp-v6-mini é a camada rápida e econômica para alto volume ou protótipos. O chirp-v6-wild é a variante mais experimental para arranjos mais livres e ousados. Cada resultado informa em model_name o modelo que realmente produziu o áudio, então você pode migrar integrações antigas com segurança.

Quickstart: crie e consulte uma tarefa

Envie um POST autenticado para /v2/generate, salve o workId retornado e consulte /v2/feed até a tarefa concluir — ou informe callback_url e aguarde o webhook.

curl
curl -X POST "https://udioapi.pro/api/v2/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "chirp-v6",
    "prompt": "Verse 1: Walking down the street, feeling so free\nChorus: Summer dreams are calling me",
    "style": "pop, upbeat, electronic, 120 bpm",
    "title": "Summer Dreams",
    "make_instrumental": false
  }'

curl -X GET "https://udioapi.pro/api/v2/feed?workId=YOUR_WORK_ID"

A geração é assíncrona. Consulte a cada 5–10 segundos com tempo limite definido e baixe as URLs de áudio prontamente — os links de mídia são temporários.

Modelos e preços do Suno v6

Os três modelos estão disponíveis em generate, upload-cover e extend. Os preços são por requisição; 1 USD compra 100 créditos.

ModeloCréditos≈ USDPosicionamento
chirp-v612≈ $0.12Principal — músicas com a maior fidelidade para lançamentos em produção
chirp-v6-mini10≈ $0.10Rápido e econômico — lotes e prototipação
chirp-v6-wild12≈ $0.12Mais experimental — arranjos ousados

Identificadores antigos continuam funcionando pelo preço histórico: chirp-v5 e chirp-v5-5 são atendidos pelo chirp-v6; chirp-v3-5, chirp-v4-0, chirp-v4-5, chirp-v4-5-plus e chirp-v4-5-all são atendidos pelo chirp-v6-mini. Omitir o campo de modelo cobra a camada base de 5 créditos atendida pelo chirp-v6-mini.

O que você pode criar

A mesma conta e chave de API liberam os endpoints de áudio documentados.

Texto e letra em música

Modo personalizado para letra, estilo e título, ou modo de inspiração a partir de uma descrição simples. O campo opcional image_urls orienta o clima.

Ler a documentação

Estender uma faixa existente

Continue uma música gerada com as configurações herdadas ou um novo prompt, e pegue o resultado no feed.

Ler a documentação

Cover do seu próprio áudio

Envie um áudio e produza uma versão cover pelo endpoint upload-cover.

Ler a documentação

Letras com marcação de tempo

Obtenha os tempos de cada linha da letra para experiências estilo karaokê ou sincronizadas.

Ler a documentação

Conversão para WAV

Converta uma faixa gerada para WAV para masterização ou fluxos de transmissão.

Ler a documentação

Webhooks e polling

Escolha entre polling no feed e notificações por callback para a conclusão da tarefa.

Ler a documentação

Como funciona

Da chave de API a uma faixa tocável em quatro passos.

  1. 1

    Crie uma chave de API

    Entre na conta, abra o painel e copie uma chave. Guarde-a como segredo no servidor — nunca no código do navegador.

  2. 2

    Envie a tarefa

    Faça POST em /v2/generate com seu modelo e prompt. A resposta retorna um workId para o job assíncrono.

  3. 3

    Consulte ou receba um callback

    Chame GET /v2/feed?workId=... a cada 5–10 segundos, ou informe callback_url e trate o webhook de conclusão.

  4. 4

    Baixe o áudio

    Com status SUCCESS, a resposta do feed contém URLs de áudio temporárias. Salve os arquivos no seu próprio armazenamento.

Preço simples por crédito

1 USD equivale a 100 créditos. Uma música com chirp-v6 custa cerca de $0.12 e com chirp-v6-mini cerca de $0.10 — você paga só pelo modelo escolhido, sem assinatura obrigatória para acessar a API.

Créditos pré-pagos nunca expiram. Requisições rejeitadas ou com falha são reembolsadas automaticamente.

Limites e observações

  • Todos os endpoints de geração são assíncronos; a resposta do POST contém um workId, não o áudio.
  • Consulte /v2/feed com novas tentativas limitadas, ou use callback_url para entrega servidor a servidor.
  • Requisições com chirp-v5 e chirp-v5-5 produzem áudio do chirp-v6; identificadores antigos produzem chirp-v6-mini.
  • As URLs de mídia são temporárias — baixe e guarde os resultados no seu próprio armazenamento.
  • Mantenha prompts, títulos e estilos dentro dos limites documentados; valores maiores são truncados.

udioapi.pro é um serviço independente de terceiros. Não é afiliado, endossado nem operado pela Suno, Udio ou MiniMax.

Perguntas frequentes sobre a Suno v6 API

Respostas sobre modelos, cobrança e o fluxo assíncrono.

Esta é a API oficial da Suno?

Não. udioapi.pro é um serviço de API independente de terceiros, com seus próprios endpoints, contas, créditos, termos e suporte. Não é afiliado, endossado nem operado pela Suno ou Udio.

Com qual modelo Suno v6 devo começar?

Use o chirp-v6-mini para prototipação e alto volume — é a camada rápida e econômica a 10 créditos. Mude para o chirp-v6 (12 créditos) quando precisar da qualidade principal, ou para o chirp-v6-wild para resultados mais experimentais.

Quanto custa uma requisição?

chirp-v6 e chirp-v6-wild custam 12 créditos por requisição, e o chirp-v6-mini custa 10. Com 1 USD = 100 créditos, isso é cerca de $0.10–$0.12 por música. Omitir o campo de modelo cobra a camada base de 5 créditos atendida pelo chirp-v6-mini.

Como obtenho o áudio gerado?

Toda requisição aceita retorna um workId. Consulte GET /v2/feed?workId=... a cada 5–10 segundos até o status SUCCESS, ou informe callback_url para receber um webhook. A resposta do feed então contém as URLs de áudio.

Meus identificadores de modelo antigos ainda funcionam?

Sim. chirp-v5 e chirp-v5-5 são atendidos pelo chirp-v6, e chirp-v3-5 até chirp-v4-5-all pelo chirp-v6-mini — cada um pelo seu preço histórico. O campo model_name informa o modelo que produziu o áudio.

Posso estender ou fazer cover de uma música gerada?

Sim — a família chirp-v6 está disponível em generate, upload-cover e extend. Extensões são cobradas pelo preço do modelo da faixa original, e requisições rejeitadas ou com falha são reembolsadas.

Continue explorando