Vai alla navigazione

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.

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
Optional text description of the music you want. A maximum of 4100 characters is allowed.
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:
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