API de geração de letras

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

Descrição do endpoint

A geração de letras cria ou reescreve letras a partir de um tema, do contexto de letras existentes e de requisitos de estilo. Este endpoint já foi atualizado para o contrato mais recente de geração de letras e pode ser usado diretamente na geração em modo profissional.

Endpoint: POST /api/lyrics/generate

Cobrança: Grátis dentro da quota (no máximo 10 chamadas por minuto e 300 por dia por utilizador); acima da quota gratuita custa 0,1 CNY por chamada.

Deteção de excesso: quando a quota gratuita é excedida, o pedido continua a ser executado normalmente e os cabeçalhos de resposta incluem X-Suno-Helper-Free: false e X-Suno-Helper-Over-Limit: minute (ou day), para que o cliente possa 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

instruction também aceita os campos antigos theme e prompt. metadata.lyrics_model é default por defeito e metadata.enable_thinking é false por defeito.

Controlo do idioma

Este endpoint não tem um campo de pedido language independente. O idioma da letra é decidido pelo conteúdo de instruction; style só pode ter um papel auxiliar.

Para gerar letras em chinês, indique o idioma de destino de forma explícita em instruction, por exemplo:

{
  "model": "suno-v6",
  "instruction": "请用中文写歌词，主题是夏夜海边重逢",
  "style": "Mandopop, 中文流行"
}

Também pode escrever "Write the lyrics in Chinese about ...". Para gerar letras em inglês, escreva "请用英文写歌词" ou "Write the lyrics in English". Se enviar apenas um tema em inglês sem indicar o idioma de destino, o resultado pode ser em inglês.

Exemplo de requisição

curl -X POST https://www.suno-api.io/api/lyrics/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "instruction": "Uma letra em português sobre a temporada de formatura e recomeçar",
    "style": "pop rock, sincero, refrão marcante",
    "title": "Recomeçar",
    "metadata": {
      "lyrics_model": "default",
      "enable_thinking": false
    }
  }'

Resposta

{
  "code": 200,
  "message": "success",
  "data": {
    "lyrics": "[Verse]\nO vento cruza o pátio\nDamos adeus ao ontem",
    "edited_lyrics": "[Verse]\nO vento cruza o pátio\nDamos adeus ao ontem",
    "lyrics_id": "lyrics_id",
    "lyrics_request_id": "lyrics_request_id"
  }
}

edited_lyrics é a letra completa que deve ser escrita na caixa de letras. lyrics_id e lyrics_request_id servem para rastreamento e podem vir vazios conforme o que o endpoint devolver; não os trate como IDs de música.

Notas de compatibilidade

• Os campos antigos theme e prompt continuam a funcionar e são mapeados para instruction.
• A série de endpoints de projetos de letras / letristas foi retirada: se precisar de guardar os resultados gerados, guarde você mesmo o edited_lyrics devolvido pelo endpoint.