Skip to main content
POST
Faixa de origem: deve vir de uma tarefa de upload criada com POST /v1/music/generations/uploadTask. Envie sua task_id e use audio_index em data.result.music[] (a partir de 1; padrão 1). Uma geração normal não pode ser usada.
custom controla quais campos valem. Todo campo enviado deve cumprir tipo, intervalo e tamanho mesmo quando não se aplica ao modo escolhido. Com custom=true, valem os campos de letra e estilo e gpt_description é ignorado. Com custom=false, só gpt_description vale e é obrigatório; sua ausência retorna 400. vocal_gender vale nos dois modos. Sem custom, o servidor infere por prompt, depois gpt_description e então tags ou title.

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).
string
obrigatório
task_id retornada por POST /v1/music/generations/uploadTask. Tarefas normais de geração não servem. Origem ausente ou inválida retorna 400 no envio.
integer
padrão:"1"
Seleciona uma faixa de data.result.music[] da tarefa de origem (a partir de 1; padrão 1).
string
padrão:"v6"
Versão pública: v6 / v6-wild / v6-mini. Padrão v6; omita ao usar custom_model_id.
string
UUID completo retornado pela tarefa de criação. Incompatível com version.
boolean
true=modo personalizado (prompt usado como letra); false=modo inspiração (usa gpt_description); se não informado, é inferido a partir do conteúdo (veja o Warning acima).
string
Letra. Tem efeito quando custom=true (ignorado no modo inspiração).
string
Prompt de inspiração. Obrigatório quando custom=false — se faltar, a requisição falha com 400 no envio (nada é cobrado).
string
Título. Só tem efeito quando custom=true.
string
Tags do estilo de destino. Só tem efeito quando custom=true.
string
Tags de estilo a excluir. Só tem efeito quando custom=true.
number
Peso do estilo, 0.00–1.00 (valores fora do intervalo retornam 400 diretamente no momento do envio). Só tem efeito quando custom=true.
number
Peso de criatividade, de 0.00 a 1.00. O nome antigo weirdness_constraint é aceito; use weirdness em novas solicitações.
number
Peso do áudio, 0.00–1.00. Só tem efeito quando custom=true.
string
Gênero vocal: Male / Female. Funciona em ambos os modos.
string
Variação de estilo: off / normal / high / extra / max.
boolean
padrão:"false"
Ativa o modo Max. Requer modo personalizado e cobra o dobro do preço padrão.
string
Formato de áudio de saída: mp3 / m4a / wav. Este endpoint não aceita duração alvo.
Esta API não aceita auto_lyrics, persona_id, instrumental nem duração alvo.
Obter resultado: consulte a tarefa assíncrona até concluir. A geração costuma levar 30–120 segundos. Leia audio_url em data.result.music[]; em caso de falha, o valor debitado é reembolsado.

Response

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