API de reforço de estilo

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

Descrição do endpoint

O reforço de estilo expande uma tag de estilo curta numa descrição de estilo mais completa e mais adequada à geração da Suno, e também pode gerar um trecho de estilo a partir da letra completa.

Endpoint: POST /api/music/boost-style

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.

Saída em chinês: quando o conteúdo da requisição (originalTags/lyrics/user_guidance) contém chinês e não declara idioma, o serviço acrescenta automaticamente （请用中文描述） depois de original_tags e inclui user_guidance=语言：简体中文；乐器名也用中文, para aumentar a taxa de acerto das descrições de estilo em chinês. Os valores realmente enviados são devolvidos em appliedOriginalTags e appliedUserGuidance na resposta. Se o conteúdo que envia já indicar um idioma (por exemplo «descreva em chinês simplificado»), o serviço não altera nada.

Autenticação

Parâmetro	Tipo	Obrigatório	Observações
Authorization	string	sim	`Bearer YOUR_API_KEY`
Content-Type	string	sim	`application/json`

Parâmetros da requisição

Parâmetro	Tipo	Obrigatório	Padrão	Observações
model	string	sim	-	Nome de modelo para o cliente: `suno-v6`, `suno-v6-wild` ou `suno-v6-mini`
originalTags	string	não	-	Tags de estilo originais
original_tags	string	não	-	Alias compatível de `originalTags`
style	string	não	-	Tags de estilo originais; alternativa a `originalTags`
instrumental	boolean	não	false	Se deve reforçar na direção de um instrumental
lyrics	string	não	-	Letra completa; ao enviá-la, gera-se uma descrição de estilo a partir do seu conteúdo
user_guidance	string	não	-	Pedido do usuário em linguagem natural, por exemplo «adicione suona e erhu, voz masculina, ritmo mais rápido»; a plataforma tem um campo com o mesmo nome e repassa-o tal como está

Exemplo de requisição

curl -X POST https://www.suno-api.io/api/music/boost-style \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "originalTags": "pop, piano, male vocal",
    "lyrics": "[Verse]\nA noite cai atrás da janela\n[Chorus]\nCaminhamos em direção à luz",
    "user_guidance": "adicione suona e erhu, voz masculina, ritmo mais rápido",
    "instrumental": false
  }'

Resposta

{
  "code": 200,
  "message": "success",
  "data": {
    "originalTags": "pop, piano, male vocal",
    "instrumental": false,
    "upsampledStyle": "Mandopop, expressive male vocal, warm piano ballad...",
    "requestId": "request_id"
  }
}

upsampledStyle é a descrição de estilo completa que deve ser escrita de volta no campo Style.

PróximoAPI de sugestões de prompt

Obter uma chave de API

Crie uma chave de API no console após o cadastro. Cada geração custa ¥0,6 e devolve 2 faixas, os downloads são ilimitados e não é preciso número de telefone.

Obter chave de API Voltar à visão geral