ElevenAPIMusic

Componer música

Compone una canción a partir de un prompt o un plan de composición.

Encabezados

xi-api-keystringOpcional

Parámetros de consulta

output_formatenumOpcionalValor predeterminado: auto

Formato de salida del audio generado. Tiene el formato codec_sample_rate_bitrate. Usa “auto” (el valor predeterminado) para que la API elija el mejor formato para el modelo seleccionado: mp3_44100_128 para modelos v1 y mp3_48000_192 para modelos v2.

Solicitud

This endpoint expects an object.
promptstring or nullOpcional<=4100 characters

Un prompt de texto sencillo a partir del que generar una canción. No puede utilizarse junto con composition_plan.

composition_planobject or nullOpcional

Un plan de composición detallado para guiar la generación de música. No puede utilizarse junto con prompt.

music_length_msinteger or nullOpcional3000-600000

La duración de la canción que se generará, en milisegundos. Solo se usa junto con prompt. Debe estar entre 3000 ms y 600000 ms. Opcional: si no se proporciona, el modelo elegirá una duración según el prompt.

model_idenumOpcionalValor predeterminado: music_v1

El modelo que se debe usar para la generación.

Valores permitidos:
seedinteger or nullOpcional0-2147483647

Semilla aleatoria para inicializar el proceso de generación de música. Proporcionar la misma semilla con los mismos parámetros puede ayudar a obtener resultados más coherentes, pero no se garantiza una reproducibilidad exacta y los resultados pueden cambiar con las actualizaciones del sistema. No se puede usar junto con prompt.

force_instrumentalbooleanOpcionalValor predeterminado: false

Si es true, garantiza que la canción generada será instrumental. Si es false, la canción puede ser instrumental o no, según el prompt. Solo se puede usar con prompt.

finetune_idstring or nullOpcional<=100 characters

El ID del finetune que se usará para la generación

respect_sections_durationsbooleanOpcionalValor predeterminado: true

Controla con qué rigor se respetan las duraciones de las secciones en composition_plan. Solo se usa con composition_plan y solo se aplica a music_v1; en music_v2 y music_v2_5, las duraciones de las secciones siempre se respetan y este parámetro se ignora. Cuando es false para music_v1, el modelo puede ajustar las duraciones de cada sección para mejorar la calidad y la latencia, manteniendo la duración total de la canción indicada en el plan.

store_for_inpaintingbooleanOpcionalValor predeterminado: false

Si se almacena la canción generada para inpainting.

sign_with_c2pabooleanOpcionalValor predeterminado: false

Si se firma la canción generada con C2PA. Solo aplicable a archivos mp3.

Encabezados de respuesta

song-idstringOpcional

Identificador único de la canción generada

Respuesta

El archivo de audio generado en el formato especificado

Errores

422
Unprocessable Entity Error