Saltar para o conteúdo principal
POST
Referenciar a faixa de origem: este endpoint não usa task_id + audio_index; você deve fornecer diretamente um audio_url de acesso público (o upstream extrai a voz dele). Se faltar, retorna 400 audio_url cannot be empty.
Este endpoint não tem dimensão de versão: não passe version — se passado, é descartado e não afeta a cobrança.

Authorizations

Authorization
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

model
string
padrão:"suno"
Modelo de áudio. Atualmente passe suno (se não informado, o padrão é suno).
audio_url
string
obrigatório
URL de acesso público da faixa de origem; o upstream extrai a voz dela. Apenas MP3 / WAV são aceitos. Se faltar, retorna 400 audio_url cannot be empty.
Obter resultado: este endpoint é uma tarefa assíncrona. Após enviar, você recebe task_id; faça polling em GET /v1/music/tasks/{task_id} a intervalos de 3–5s, até que status seja completed ou failed (normalmente leva 30–120s; durante a geração, status é pending e progress vai de na fila 10 → pronto 50 → concluído 100). O resultado contém as informações do timbre criado. Em caso de falha, data.error.message informa o motivo e a cota pré-reservada é automaticamente devolvida.

Response

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