Skip to main content
POST
Referência do áudio de origem: não são necessários IDs extras para faixas baseadas em músicas existentes. Envie a task_id da tarefa de origem e audio_index para selecionar em data.result.music[] (a partir de 1; padrão 1).
Em extend, custom é opcional e o padrão é true. Com custom=true, prompt contém a letra da continuação. Somente custom=false explícito faz gpt_description orientar a extensão.

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
O task_id da tarefa que gerou a faixa de origem. Se ausente ou se a origem não puder ser resolvida, um 400 é retornado no momento do envio.
integer
padrão:"1"
Seleciona uma faixa de data.result.music[] da tarefa de origem (a partir de 1; padrão 1).
number
obrigatório
Segundo em que a continuação começa; deve ser pelo menos 1 e menor que a duração real da faixa. Aceita decimais.
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
padrão:"true"
true = continuar com a letra de prompt; false = continuação por inspiração. Padrão quando omitido: true.
string
Letra da extensão. Tem efeito quando custom=true.
string
Descrição de inspiração. Só vale com custom=false explícito e orienta a extensão.
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.
string
Gênero vocal: Male / Female. Funciona em ambos os modos.
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.
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.
integer
Duração alvo de 10–360 segundos. Só com custom=true; a duração real depende do resultado.
string
Variação de estilo: off / normal / high / extra / max. Opcional.
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.
Resultado: consulte a tarefa até concluir e leia a audio_url da faixa estendida 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