Skip to main content
Gere música e letras usando IA. Esta é uma API assíncrona. A resposta de criação retorna uma identidade de tarefa e, quando disponível, também pode incluir um poll_url preferido.

Corpo da Requisição

string
padrão:"suno_music"
Modelo a ser usado: suno_music para geração de música, suno_lyrics apenas para letras.
string
Descrição da música. Obrigatório para solicitações music, lyrics, upload-cover e upload-extend; omita em add-instrumental.
string
Título para a música gerada.
string
Tags de estilo (ex: “pop, upbeat, electronic”).
string
Estilos a evitar. Obrigatório quando audio_operation é add-instrumental.
string
Tipo de geração: MUSIC (padrão) ou LYRICS.
string
Versão oficial do modelo Suno. Obrigatória para geração de música (quando action é omitido ou é MUSIC); omita em solicitações apenas de letras. Valores aceitos: chirp-v3-5, chirp-v4, chirp-v4-5, chirp-v4.5, chirp-v4-5plus, chirp-v4.5plus, chirp-v4-5all, chirp-v4.5all, chirp-v5, chirp-v5-5, chirp-v5.5.
boolean
Defina como true para gerar uma saída instrumental sem vocais.
string
URL de áudio de referência ou enviado que seja publicamente acessível. Sem audio_operation, a TokenLab usa o fluxo upload-cover.
string
Modo de áudio enviado: upload-cover, upload-extend ou add-instrumental. upload-extend exige continue_at; add-instrumental exige audio_url, title, tags e negative_tags.
string
ID de um clipe anterior para continuar a partir dele.
number
Carimbo de tempo, em segundos, a partir do qual continuar. Obrigatório quando audio_operation é upload-extend.

Resposta

string
ID da tarefa para consultar o status.
string
Alias do identificador da tarefa assíncrona quando retornado pelo adaptador.
string
URL de polling prioritária quando disponível.
string
Status da tarefa: pending, processing, completed ou failed.
integer
Timestamp Unix da criação da tarefa.