Saltar a la navegación

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.

enable_loggingbooleanOpcionalValor predeterminado: true

Cuando enable_logging se establece en false, se usará el modo de retención cero para la solicitud. El modo de retención cero solo puede utilizarse por clientes Enterprise.

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