Saltar para o conteúdo principal
POST
Este endpoint não tem dimensão de versão: não passe version — se for passado, é descartado e não afeta a cobrança.
Limitação conhecida: não envie áudio puramente instrumental (sem vocais) — o upstream pode falhar na análise.

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).
audioFilePath
string
obrigatório
URL direta de áudio publicamente acessível. Se ausente, um 400 é retornado no momento do envio (sem chamada ao upstream, sem cobrança).
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 (durante a geração, status é pending e progress avança: na fila 10 → pronto 50 → concluído 100). Após a conclusão, use o task_id desta tarefa + audio_index=1 como fonte para outras operações. 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