Skip to main content
POST
Referenciar faixas de origem: mashup requer exatamente 2 faixas de origem — especifique-as via task_ids (um array de exatamente 2 dos seus task_id), com audio_indexes opcional (um array paralelo que indica qual item do music[] de cada tarefa, baseado em 1, padrão 1 para ambos).
custom determina quais campos são usados. Todos os valores enviados devem atender aos requisitos de tipo, intervalo e comprimento, mesmo que o campo não seja usado no modo selecionado. Com custom=true, prompt contém a letra e pode ser obrigatório quando instrumental=false, conforme as condições abaixo. Com custom=false, gpt_description é obrigatório. Se custom for omitido, o backend deduz o modo a partir de prompt, gpt_description, tags e 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
Array dos seus task_id para as 2 faixas de origem (deve ser exatamente 2; qualquer outra quantidade retorna 400 diretamente no envio).
integer[]
Array paralelo a task_ids que seleciona uma faixa de data.result.music[] em cada tarefa (a partir de 1; padrão de cada item 1).
boolean
padrão:"false"
Se é puramente instrumental (true=sem vocais). Se não informado, o padrão é false (com vocais).
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 e persona_id.
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 aviso acima).
string
Obrigatório sob condição: forneça a letra quando custom=true && instrumental=false. O campo não é usado no modo de inspiração, mas qualquer valor enviado ainda deve respeitar o limite de comprimento.
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 de estilo. Só tem efeito quando custom=true.
string
Tags de estilo a excluir. Só tem efeito quando custom=true.
boolean
true=reescreve a letra fornecida de forma criativa. Só tem efeito quando custom=true.
number
Peso do estilo, 0.00–1.00 (valores fora do intervalo retornam 400 diretamente no envio). Só tem efeito quando custom=true.
number
Peso de criatividade, de 0.00 a 1.00. weirdness_constraint é um alias de compatibilidade; use weirdness em novas solicitações.
number
Peso de áudio, 0.00–1.00. Só tem efeito quando custom=true.
string
Gênero vocal: Male / Female. Funciona em ambos os modos.
string
ID de estilo da Persona. Só vale com custom=true e é incompatível com custom_model_id.
string
Variação de estilo: off / normal / high / extra / max. Opcional.
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.
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