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).
array
obrigatório
Array de 1–4 URLs de áudio publicamente acessíveis.
string
padrão:"v6"
Versão pública: v6 / v6-wild / v6-mini. Padrão v6; omita ao usar custom_model_id.
string
UUID completo retornado pela tarefa de criação. Incompatível com version.
string
Letra / conteúdo.
string
Título.
string
Tags de estilo.
string
Tags de estilo a excluir.
number
Peso do estilo, 0.00–1.00.
number
Peso de criatividade, de 0.00 a 1.00. O nome antigo weirdness_constraint é aceito; use weirdness em novas solicitações.
number
Peso do áudio, 0.00–1.00.
string
Gênero vocal: Male / Female.
boolean
true=reescrever criativamente a letra fornecida.
string
Variação de estilo: off / normal / high / extra / max. Opcional.
boolean
padrão:"false"
Ativa o modo Max e cobra o dobro do preço padrão.
string
Formato de áudio de saída: mp3 / m4a / wav.
Esta API aceita de 1 a 4 links públicos de áudio e não envia custom, instrumental, gpt_description, persona_id nem duração alvo.
Obter resultado: consulte a tarefa assíncrona até concluir. A geração costuma levar 30–120 segundos. Leia audio_url em data.result.music[]; em caso de falha, o valor debitado é reembolsado.

Response

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