Vai alla navigazione
ElevenAPIMusic

Da video a musica

Genera musica di sottofondo da uno o più file video. I video vengono combinati in ordine. La descrizione facoltativa e i tag di stile influenzano la musica generata.

Header

xi-api-keystringOpzionale

Parametri di query

output_formatenumOpzionale

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_loggingbooleanOpzionalePredefinito a true

Quando enable_logging è impostato su false, per la richiesta verrà usata la modalità a conservazione zero. La modalità a conservazione zero può essere usata solo dai clienti Enterprise.

Richiesta

This endpoint expects a multipart form with multiple files.
videosfilesObbligatorio

Uno o più file video inviati tramite array FormData (multipart/form-data). Verranno combinati in un unico codec nell’ordine specificato. Sono consentiti al massimo 10 video, con una dimensione totale del video combinato limitata a 200 MB. In totale, il video può durare fino a 600 secondi. Tieni presente che la combinazione di più video può aumentare significativamente la durata della richiesta. Se possibile, combina i video in anticipo.

descriptionstring or nullOpzionale1-4100 characters
Descrizione testuale facoltativa della musica desiderata. Sono consentiti al massimo 4100 caratteri.
tagslist of stringsOpzionalePredefinito a []

Elenco facoltativo di tag di stile (ad es. [‘upbeat’, ‘cinematic’]). Sono consentiti al massimo 10 tag.

model_idenumOpzionalePredefinito a music_v1
Il modello da usare per la generazione.
Valori consentiti:
add_sfxbooleanOpzionalePredefinito a false

Quando è true, incorpora i segnali degli SFX dal video.

separate_tracksbooleanOpzionalePredefinito a false

Quando è true, restituisci un file ZIP con tracce audio separate per musica e SFX anziché un singolo file mixato. Usalo per avere maggiore flessibilità nella sovrapposizione delle tracce.

use_audio_as_referencebooleanOpzionalePredefinito a false

Quando è true, analizza la traccia audio del video e usa generi, BPM, strumentazione, atmosfera e sviluppo come caratteristiche di riferimento per la generazione musicale.

sign_with_c2pabooleanOpzionalePredefinito a false
Indica se firmare la canzone generata con C2PA. Si applica solo ai file mp3.

Header di risposta

song-idstringOpzionale
Identificatore univoco della canzone generata

Risposta

File audio generato corrispondente al video. Il Content-Type e l’estensione del file dipendono dal parametro output_format (mp3 per impostazione predefinita).

Errori

403
Forbidden Error
422
Unprocessable Entity Error