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).

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).
string
A letra do trecho a ser substituído.
number
obrigatório
Ponto inicial da substituição (segundos). Se ausente, retorna 400 imediatamente.
number
obrigatório
Fim em segundos. Deve cumprir 0 ≤ start_s < end_s e não superar a duração conhecida.
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.
string
Letra de contexto.
string
Título.
string
Tags de estilo.
string
Tags de estilo a excluir.
string
Variação de estilo: off / normal / high / extra / max. Opcional.
boolean
padrão:"false"
Ativa o modo Max 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.
prompt é o contexto da letra original e infill_lyrics a nova letra. Não envie custom, instrumental, auto_lyrics nem campos antigos da sessão de edição.
Obter resultado: consulte a tarefa até concluir e leia a audio_url da faixa substituída 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