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.

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).
prompt
string
obrigatório
Letra / conteúdo.
lyrics_model
string
Modelo de letra: classic / remi (repassado ao upstream; se não informado, é usado o padrão do upstream).
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, o resultado contém o texto da letra gerada. 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