API de sugestões de prompt

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

Descrição do endpoint

O endpoint de sugestões de prompt devolve descrições de músicas, temas de letra e sugestões de tags de estilo aleatórias. Serve para botões de "inspiração aleatória" e "atualizar tags".

Endpoint: POST /api/prompts/suggestions

Cobrança: Grátis dentro da cota (no máximo 10 chamadas por minuto e 300 por dia por usuário); acima da cota gratuita é cobrado ¥0,1 por chamada.

Detectar o excesso: quando a cota gratuita é ultrapassada a requisição continua funcionando normalmente, e os cabeçalhos de resposta trazem X-Suno-Helper-Free: false e X-Suno-Helper-Over-Limit: minute (ou day), para o cliente avisar que esta chamada foi cobrada.

Modelo recomendado: suno-v6. suno-v6, suno-v6-wild e suno-v6-mini estão disponíveis.

Autenticação

Parâmetros da requisição

Exemplo de requisição

curl -X POST https://www.suno-api.io/api/prompts/suggestions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6"
  }'

Resposta

{
  "code": 200,
  "message": "success",
  "data": {
    "prompts": ["A dreamy synth-pop track about city lights after rain"],
    "lyrics_prompts": ["Escreva uma letra em português sobre a noite, o reencontro e o arrependimento"],
    "tags": ["dreamy synth-pop", "warm piano", "male vocal"],
    "is_pending_personalization": false
  }
}

Campos da resposta