Skip to main content
POST
custom controla a interpretação dos campos de texto. Com custom=true, prompt contém a letra e valem title, style, negative_tags, auto_lyrics e persona_id. Com custom=false, prompt contém a inspiração e os campos personalizados são ignorados. style_weight, weirdness_constraint, audio_weight e vocal_gender são validados nos dois modos.
Este endpoint usa nomes de campos um pouco diferentes: style em vez de tags.

Authorizations

string
obrigatório
Todos os endpoints exigem autenticação com Bearer TokenObter a API Key:Acesse a página de gerenciamento de API Key para obter sua API KeyAo usar, adicione ao cabeçalho da requisição:

Body

string
padrão:"suno"
Modelo de áudio. Atualmente passe suno (se não informado, o padrão é suno).
boolean
padrão:"false"
false=modo inspiração; true=modo personalizado (prompt como letra). O padrão é false.
boolean
padrão:"false"
true=música puramente instrumental, sem vocais. O padrão é false.
string
Versão pública: v6 / v6-wild / v6-mini. Este campo ou custom_model_id é obrigatório; omita-o ao usar modelo personalizado.
string
UUID completo da tarefa do modelo personalizado. Incompatível com version e persona_id; ao informar este campo, aplica-se a tarifa do modelo personalizado.
string
Inspiração/letra. Obrigatória com custom=false, até 3.000 caracteres; também obrigatória com custom=true e instrumental=false, até 5.000. Opcional em instrumental personalizado.
string
Título do modo personalizado, até 80 caracteres. Ignorado com custom=false.
string
Tag de estilo no modo personalizado, até 1.000 caracteres. Ignorada com custom=false.
string
Tags de estilo negativas (estilos que você não quer). Só tem efeito quando custom=true.
boolean
true=reescrever criativamente a letra fornecida. Só tem efeito quando custom=true.
string
ID de estilo da Persona. Só vale com custom=true e é incompatível com custom_model_id.
string
Gênero vocal: Male / Female (também aceita m / f / male / female, normalizados automaticamente pelo backend). Funciona em ambos os modos.
number
Peso do estilo, de 0.00 a 1.00. Validado e aplicado nos dois modos.
number
Pontuação de criatividade, de 0.00 a 1.00. Validada e aplicada nos dois modos.
number
Peso do áudio, de 0.00 a 1.00. Validado e aplicado nos dois modos.
string
Variação de estilo: off / normal / high / extra / max. Opcional, sem padrão fixo.
boolean
padrão:"false"
Se deve ativar o modo Max. Exige custom=true e custa o dobro do preço normal.
string
Formato de áudio de saída: mp3 / m4a / wav. Se omitido, o serviço escolhe o padrão.
integer
Duração alvo de 10–360 segundos. Só com custom=true; a duração final depende do resultado da tarefa.
Obter resultado: consulte a tarefa assíncrona a cada 3–5 segundos. A geração costuma levar 30–120 segundos; o estado pode ser pending ou processing e o progresso não muda necessariamente em intervalos fixos. Ao concluir, leia audio_url em data.result.music[] (também há image_url, video_url, title, duration etc.). Em caso de falha, o valor debitado é reembolsado.

Response

integer
Código de status da resposta
array
Array de dados retornados