Adicionar música gerada por IA a um produto costumava significar licenciar uma biblioteca de músicas ou contratar um compositor. Em 2026, você pode chamar o Suno v4.5 e obter uma música completa de 4 minutos com vocais, harmonia e produção — em cerca de 60 segundos de tempo de execução, por menos de $0.50.

Este post apresenta uma integração completa, desde o primeiro curl até a entrega de áudio via webhook no seu app.

1. Obtenha uma chave de API

Cadastre-se em aimarcus.eu/aigenerate/register. Os $10 gratuitos no cadastro são suficientes para ~20 músicas do Suno v4.5 para começar.

2. Inicie uma geração

POST https://aimarcus.eu/aigenerate/api/v1/generate
Authorization: Bearer sk-aig-YOUR_KEY
Content-Type: application/json

{
  "model": "V4_5",
  "prompt": "Upbeat synthwave, driving bass, retro 80s vibe",
  "customMode": false,
  "instrumental": false,
  "callBackUrl": "https://your-app.com/webhooks/suno"
}

Resposta:

{ "code": 200, "data": { "taskId": "f0147a2e78670ecbce46020219f931a1" } }

3. Letras personalizadas

Defina customMode: true e passe suas letras no prompt. O Suno cuida da melodia, arranjo, harmonia e performance vocal.

{
  "model": "V4_5",
  "customMode": true,
  "prompt": "[Verse 1]\nWaking up to a city that never sleeps...",
  "style": "indie pop ballad",
  "title": "Midnight City",
  "callBackUrl": "..."
}

4. Polling ou webhook

Duas opções:

  • Polling: GET /api/v1/generate/record-info?taskId=... a cada 5 segundos até state="success". Endpoints de polling são gratuitos — não contam contra seu limite de taxa ou custo.
  • Webhook: forneça um callBackUrl. Quando a música estiver pronta, enviamos o JSON do resultado para sua URL com uma assinatura HMAC-SHA256 no cabeçalho X-AI-Signature.

5. Payload final

A conclusão bem-sucedida retorna dois URLs de áudio (o Suno gera variações):

{
  "data": {
    "state": "success",
    "response": {
      "sunoData": [
        { "audioUrl": "https://.../track-a.mp3", "duration": 185 },
        { "audioUrl": "https://.../track-b.mp3", "duration": 194 }
      ]
    }
  }
}

Ambos são MP3, 44.1 kHz, prontos para reprodução. Eles permanecem nos URLs indefinidamente, mas para produção você deve baixá-los e hospedá-los no seu próprio CDN.

6. Dicas para produção

  • Cache no seu CDN — os URLs do Suno são rápidos, mas você controla seu próprio SLA ao hospedar.
  • Armazene o taskId no seu banco de dados vinculado à solicitação do usuário — facilita reprocessamento e auditoria.
  • Defina um limite diário de gastos nas configurações do painel se você expuser isso para usuários finais.
  • Para narração estilo podcast, use um modelo TTS dedicado (mais rápido e barato que o Suno).

Esse é o ciclo completo. O mesmo padrão funciona para Suno v3.5, v4, v4.5 Plus, MusicGen e Mureka — basta alterar o campo model.