Skip to main content
Genera música y letras utilizando IA. Esta es una API asíncrona. La respuesta de creación devuelve una identidad de tarea y, cuando está disponible, también puede incluir un poll_url preferido.

Cuerpo de la solicitud

string
predeterminado:"suno_music"
Modelo a utilizar: suno_music para generación de música, suno_lyrics solo para letras.
string
Descripción de la música. Obligatorio para solicitudes music, lyrics, upload-cover y upload-extend; omítelo para add-instrumental.
string
Título para la canción generada.
string
Etiquetas de estilo (por ejemplo, “pop, upbeat, electronic”).
string
Estilos que se deben evitar. Es obligatorio cuando audio_operation es add-instrumental.
string
Tipo de generación: MUSIC (predeterminado) o LYRICS.
string
Versión oficial del modelo Suno. Obligatoria para la generación de música (cuando se omite action o es MUSIC); omítela en solicitudes solo de letras. Valores admitidos: 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
Establécelo en true para generar una salida instrumental sin voces.
string
URL de audio de referencia o subido que sea accesible públicamente. Si se envía sin audio_operation, TokenLab usa el flujo upload-cover.
string
Modo de audio subido: upload-cover, upload-extend o add-instrumental. upload-extend requiere continue_at; add-instrumental requiere audio_url, title, tags y negative_tags.
string
ID de un clip anterior desde el cual continuar.
number
Marca de tiempo en segundos desde la que continuar. Obligatorio cuando audio_operation es upload-extend.

Respuesta

string
ID de la tarea para consultar el estado.
string
Alias del identificador de tarea asíncrona cuando el adaptador lo devuelve.
string
URL de polling prioritaria cuando está disponible.
string
Estado de la tarea: pending, processing, completed o failed.
integer
Marca de tiempo Unix de la creación de la tarea.