Skip to main content
POST

Authorizations

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

string
padrão:"suno"
Modelo de áudio. Atualmente passe suno (se não informado, o padrão é suno).
string
padrão:"v6"
Versão pública: v6 / v6-wild / v6-mini; padrão quando omitida: v6.
string
obrigatório
Descrição textual do efeito sonoro. Se ausente, um 400 é retornado no momento do envio (sem cobrança). Prefira prompts em inglês para obter melhores resultados.
string
padrão:"one-shot"
Tipo de efeito sonoro: one-shot (padrão, disparo único) / loop (repetível).
integer
Tempo, 1–300; valores fora do intervalo retornam 400 diretamente no momento do envio.
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).
string
Formato de áudio de saída: mp3 / m4a / wav.
Esta API não aceita modelos personalizados, Max, variety nem duração alvo.
Obter resultado: esta API cria uma tarefa assíncrona. Consulte GET /v1/music/tasks/{task_id} a cada 3–5 segundos até status ser completed ou failed. Durante o processamento, pode ser pending ou processing; progress é um inteiro de 0 a 100, sem mudança em intervalos fixos garantida. Ao concluir, leia audio_url em data.result.music[]. Em caso de falha, o motivo fica em data.error.message e o valor debitado é reembolsado automaticamente.

Response

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