Saltar para o conteúdo principal
POST

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).
version
string
padrão:"v5.5"
Versão de geração: apenas v5 / v5.5; se não informado, o padrão é v5.5.
prompt
string
obrigatório
Descrição textual do efeito sonoro (mapeada para o sound do upstream). Se ausente, um 400 é retornado no momento do envio (sem chamada ao upstream, sem cobrança).
type
string
padrão:"one-shot"
Tipo de efeito sonoro: one-shot (padrão, disparo único) / loop (repetível).
bpm
integer
Tempo, 1300; valores fora do intervalo retornam 400 diretamente no momento do envio.
key
string
Enumeração de tom musical: tons maiores C / C# / D / D# / E / F / F# / G / G# / A / A# / B; tons menores adicionam m (Cm / C#m / … / Bm). Apenas a notação com sustenidos (#) é suportada; bemóis (Db / Eb, etc.) e B# retornam 400 (key param error).
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). Ao concluir, pegue audio_url em data.result.music[]. Em caso de falha, data.error.message indica o motivo e a cota pré-reservada é automaticamente devolvida.

Response

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