Saltar a la navegación
ElevenAPIMusic

Vídeo a Música

Genera música de fondo a partir de uno o varios archivos de vídeo. Los vídeos se combinan en orden. Las etiquetas opcionales de descripción y estilo influyen en la música generada.

Encabezados

xi-api-keystringOpcional

Parámetros de consulta

output_formatenumOpcional

Output format of the generated audio. Formatted as codec_sample_rate_bitrate. So an mp3 with 22.05kHz sample rate at 32kbs is represented as mp3_22050_32. MP3 with 192kbps bitrate requires you to be subscribed to Creator tier or above. PCM with 44.1kHz sample rate requires you to be subscribed to Pro tier or above. Note that the μ-law format (sometimes written mu-law, often approximated as u-law) is commonly used for Twilio audio inputs.

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 a multipart form with multiple files.
videosfilesRequerido

Uno o más archivos de vídeo enviados mediante una matriz FormData (multipart/form-data). Se combinarán en un único códec por orden. Se permite un máximo de 10 vídeos y el tamaño total del vídeo combinado está limitado a 200 MB. En total, el vídeo puede durar hasta 600 segundos. Ten en cuenta que combinar varios vídeos puede aumentar considerablemente la duración de la solicitud. Si es posible, combina los vídeos previamente.

descriptionstring or nullOpcional1-4100 characters

Descripción de texto opcional de la música que quieres. Se permite un máximo de 4100 caracteres.

tagslist of stringsOpcionalValor predeterminado: []

Lista opcional de etiquetas de estilo (por ejemplo, [‘upbeat’, ‘cinematic’]). Se permite un máximo de 10 etiquetas.

model_idenumOpcionalValor predeterminado: music_v1

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

Valores permitidos:
add_sfxbooleanOpcionalValor predeterminado: false
When true, incorporate SFX cues from the video.
separate_tracksbooleanOpcionalValor predeterminado: false
When true, return a ZIP with separate music and SFX audio tracks instead of a single mixed file. Use this for more flexibility to layer the tracks.
use_audio_as_referencebooleanOpcionalValor predeterminado: false
When true, analyze the video's audio track and use its genres, BPM, instrumentation, mood, and arc as reference characteristics for music generation.
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

Archivo de audio generado que coincide con el vídeo. El Content-Type y la extensión de archivo dependen del parámetro output_format (mp3 de forma predeterminada).

Errores

403
Forbidden Error
422
Unprocessable Entity Error