Skip to main content
POST
Este endpoint estende diretamente uma URL pública de áudio; não é preciso chamar uploadTask antes. Ele sempre usa modo personalizado; não envie custom, instrumental nem gpt_description.

Authorizations

string
obrigatório
Bearer Token. Obtenha a chave na página de gerenciamento de chaves de API.

Body

string
padrão:"suno"
Use sempre suno.
string
obrigatório
URL HTTP(S) direta e pública para um áudio. O áudio de origem deve ter menos de 8 minutos. Caminhos locais e URLs blob: não são aceitos.
number
obrigatório
Início da extensão. Deve ser pelo menos 1 segundo e menor que a duração real do áudio de origem.
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.
string
Letra da extensão, até 5.000 caracteres. Se omitida, a extensão é instrumental.
string
Descrição do estilo, até 1.000 caracteres.
string
Título, até 80 caracteres.
string
Estilos a excluir.
number
Peso do estilo, de 0 a 1.
number
Peso de criatividade, de 0 a 1.
number
Peso do áudio, de 0 a 1.
boolean
Se deve criar uma segunda versão da letra enviada.
string
Gênero da voz: Male ou Female.
string
ID da Persona, incompatível com custom_model_id.
integer
Duração alvo, de 10 a 360 segundos. A duração real vem do resultado da tarefa.
string
Variação de estilo: off / normal / high / extra / max.
boolean
padrão:"false"
Ativa o modo Max e cobra o dobro do preço padrão.
string
Formato de saída: mp3 / m4a / wav.

Response

integer
Código de status da resposta.
array
Resultado do envio. Leia data[0].task_id e consulte a API de tarefas.