Música

Crear música

Crea una tarea de generación de música, letras o sonido

POST
/v1/music/generations

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

modelstringpredeterminado: suno-music

ID 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.

promptstring

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.

titlestring

Título de la canción generada.

tagsstring

Etiquetas de estilo (por ejemplo, "pop, upbeat, electronic").

negative_tagsstring

Estilos que se deben evitar. Obligatorio cuando audio_operation es add-instrumental.

actionstring

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.

mvstring

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.

make_instrumentalboolean

Establézcalo en true para generar una salida instrumental sin voces.

audio_urlstring

URL de audio de referencia o subido accesible públicamente. Cuando se proporciona sin audio_operation, TokenLab utiliza el flujo upload-cover.

audio_operationstring

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.

task_idstring

ID de la tarea de origen perteneciente a su organización, para reemplazo de audio generado o separación de stems.

audio_idstring

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.

infill_start_snumber

Tiempo de inicio del reemplazo en segundos, al menos 0. Obligatorio para replace-section.

infill_end_snumber

Tiempo de finalización del reemplazo en segundos. Obligatorio para replace-section; debe ser de 6 a 60 segundos posterior a infill_start_s.

full_lyricsstring

Letra completa de la canción resultante. Obligatorio para replace-section.

stem_namestring

Nombre del stem. Obligatorio para advanced-split.

continue_clip_idstring

ID de un clip anterior desde el cual continuar.

continue_atnumber

Tiempo en segundos desde el cual continuar. Obligatorio y mayor que 0 para upload-extend.

durationinteger

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.

output_formatstring

Formato de archivo de audio listado por el modelo, por ejemplo mp3, wav o flac. Solo para modelos que lo incluyan.

seedinteger

Semilla para obtener resultados reproducibles, de 0 a 4294967294. Solo para modelos que lo indiquen.

stepsinteger

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.

cfg_scalenumber

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

idstring

ID de la tarea para consultar el estado.

task_idstring

Alias del mismo ID de tarea asíncrona, cuando se devuelve.

poll_urlstring

URL de estado para esta tarea. Consulte GET /v1/tasks/{id} con id.

statusstring

Estado de la tarea: pending, processing, completed o failed.

createdinteger

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

Response
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "model": "suno-music"
}

Autorización

BearerAuth
AuthorizationBearer <token>

Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.

Ubicación: header

Encabezados

X-TokenLab-Delivery-Policy?string

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"
Idempotency-Key?string

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.

Longitud1 <= length <= 255

Cuerpo de la solicitud

application/json

Respuesta

application/json

application/json

application/json

application/json

application/json

application/json