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).
audio_urls
array
obrigatório
Array de 1–4 URLs de áudio publicamente acessíveis.
version
string
padrão:"v5.5"
Versão de geração: v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, afeta a qualidade do áudio e a cobrança; se não informado, o padrão é v5.5.
prompt
string
Letra / conteúdo.
title
string
Título.
tags
string
Tags de estilo.
negative_tags
string
Tags de estilo a excluir.
style_weight
number
Peso do estilo, 0.001.00.
weirdness_constraint
number
Peso de criatividade, 0.001.00 (alias weirdness).
audio_weight
number
Peso do áudio, 0.001.00.
vocal_gender
string
Gênero vocal: Male / Female.
auto_lyrics
boolean
true=reescrever criativamente a letra fornecida.
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 (a geração de música normalmente leva 30–120s; 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 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