Música
Crear música
Crea una tarea de generación de música, letras o sonido
Use GET /v1/models?recommended_for=music para obtener los modelos de música actuales.
Genere música, letras y sonido con IA. Esta es una API asíncrona. Las respuestas de creación devuelven un identificador de tarea. Consulte periódicamente GET /v1/tasks/{id} con él para conocer el estado.
Los modelos difieren en los campos que aceptan. Consulte GET /v1/models/{model} antes de enviar campos opcionales; un campo que el modelo no incluya puede devolver 400 unsupported_parameter. Los campos de Suno (mv, title, tags, negative_tags, audio_operation y los campos asociados a ellos) se aplican a los modelos de Suno. user no es compatible y devuelve 400.
Cuerpo de la solicitud
suno-musicID del modelo de música, como suno-music o stable-audio-3. Envíelo explícitamente. Para generar únicamente letras, elija un modelo cuyas operaciones públicas actuales incluyan lyrics.
Descripción de la música o texto de reemplazo. Obligatorio para música, letras, upload-cover, upload-extend y replace-section; opcional para add-instrumental y separación de stems.
Título de la canción generada.
Etiquetas de estilo (por ejemplo, "pop, upbeat, electronic").
Estilos que se deben evitar. Obligatorio cuando audio_operation es add-instrumental.
Valor opcional MUSIC o LYRICS. Elija un modelo que admita la operación pública correspondiente; este campo no añade compatibilidad con letras a un modelo exclusivo de música.
Selector de versión de Suno. Obligatorio para generación, upload-cover, upload-extend, add-instrumental y reemplazo desde audio_url. Omítalo para letras, reemplazo desde task_id + audio_id y separación de stems. Valores aceptados: chirp-v6, chirp-v6-mini, chirp-v6-wild.
Establézcalo en true para generar una salida instrumental sin voces.
URL de audio de referencia o subido accesible públicamente. Cuando se proporciona sin audio_operation, TokenLab utiliza el flujo upload-cover.
Operación de audio: upload-cover, upload-extend, add-instrumental, replace-section, vocal-separate, multi-stem-separation, advanced-split.
vocal-separate, multi-stem-separation y advanced-split requieren task_id + audio_id; advanced-split también requiere stem_name. upload-extend requiere que continue_at sea mayor que 0. add-instrumental requiere audio_url, title, tags y negative_tags.
Para replace-section, envíe prompt, tags, title, infill_start_s, infill_end_s y full_lyrics. Elija exactamente un origen: task_id + audio_id, o audio_url + mv. El intervalo de reemplazo debe ser de 6 a 60 segundos.
ID de la tarea de origen perteneciente a su organización, para reemplazo de audio generado o separación de stems.
ID del audio de origen devuelto en el resultado de la tarea de origen. Obligatorio junto con task_id para el reemplazo de audio generado y la separación de stems.
Tiempo de inicio del reemplazo en segundos, al menos 0. Obligatorio para replace-section.
Tiempo de finalización del reemplazo en segundos. Obligatorio para replace-section; debe ser de 6 a 60 segundos posterior a infill_start_s.
Letra completa de la canción resultante. Obligatorio para replace-section.
Nombre del stem. Obligatorio para advanced-split.
ID de un clip anterior desde el cual continuar.
Tiempo en segundos desde el cual continuar. Obligatorio y mayor que 0 para upload-extend.
Duración del audio generado en segundos, de 1 a 380. Solo para modelos que lo indiquen, como stable-audio-3; los detalles del propio modelo especifican su límite.
Formato de archivo de audio listado por el modelo, por ejemplo mp3, wav o flac. Solo para modelos que lo incluyan.
Semilla para obtener resultados reproducibles, de 0 a 4294967294. Solo para modelos que lo indiquen.
Número de pasos de generación. El rango depende del modelo (por ejemplo, de 4 a 8 para stable-audio-3). Solo para modelos que lo incluyan.
Algunos modelos incluyen más campos, como negative_prompt, n, seconds y guidance_scale. Envíelos solo cuando los detalles del modelo los incluyan; un campo que el modelo seleccionado no admita devolverá un 400.
Fuerza de guía del prompt, de 1 a 25. Solo para modelos que lo indiquen.
prompt acepta hasta 5000 caracteres; tags y negative_tags aceptan hasta 1000 caracteres cada uno. Las operaciones y parámetros admitidos dependen de los detalles actuales del modelo seleccionado.
Respuesta
ID de la tarea para consultar el estado.
Alias del mismo ID de tarea asíncrona, cuando se devuelve.
URL de estado para esta tarea. Consulte GET /v1/tasks/{id} con id.
Estado de la tarea: pending, processing, completed o failed.
Hora de creación de la tarea como marca de tiempo Unix, cuando se devuelve.
Solicitud
curl -X POST "https://api.tokenlab.sh/v1/music/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-music",
"mv": "chirp-v6",
"prompt": "An upbeat electronic dance track with heavy bass",
"title": "Night Drive",
"tags": "electronic, EDM, energetic"
}'Ejemplo de generación de sonido para un modelo que acepta duration y output_format en lugar de los campos de Suno:
{
"model": "stable-audio-3",
"prompt": "Warm lo-fi beat with soft vinyl crackle",
"duration": 30,
"output_format": "mp3"
}Respuesta
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "pending",
"model": "suno-music"
}Autorización
BearerAuth Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Encabezados
Política de entrega por solicitud. Sustituye los valores predeterminados de la API key y del Workspace. Auto intenta primero con TokenLab Verified y puede cambiar una vez a Official solo antes de la salida, la aceptación de la solicitud o la creación de recursos persistentes.
Valores permitidos
- "auto"
- "verified"
- "official"
Clave opcional que hace que una solicitud de creación sea segura para reintentar. Envíe un nuevo valor único, como un UUID, para cada tarea. Un reintento con la misma clave y el mismo cuerpo devuelve el resultado de la solicitud de creación original, generalmente la tarea original, y no crea, envía ni cobra una segunda tarea. Un cuerpo diferente con una clave que ya fue aceptada se rechaza con 409. Se ignora una clave de más de 255 caracteres y la solicitud no tendrá protección de idempotencia. Consulte Reintente de forma segura con una clave de idempotencia.
1 <= length <= 255Cuerpo de la solicitud
application/json
Respuesta
application/json
application/json
application/json
application/json
application/json
application/json