Skip to navigation
ElevenAPIMusic

Video to Music

Genereer achtergrondmuziek op basis van een of meer videobestanden. Video’s worden op volgorde gecombineerd. Optionele beschrijvingen en styletags beïnvloeden de gegenereerde muziek.

Headers

xi-api-keystringOptional

Query parameters

output_formatenumOptional

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.

Request

This endpoint expects a multipart form with multiple files.
videosfilesRequired

Een of meer videobestanden die via een FormData-array (multipart/form-data) worden verzonden. Ze worden op volgorde gecombineerd tot één codec. Er zijn maximaal 10 video’s toegestaan, waarbij de totale grootte van de gecombineerde video beperkt is tot 200 MB. In totaal mag de video maximaal 600 seconden lang zijn. Let op: het combineren van meerdere video’s kan de requestduur aanzienlijk verlengen. Combineer de video’s indien mogelijk vooraf.

descriptionstring or nullOptional1-4100 characters
Optionele tekstbeschrijving van de muziek die je wilt. Er zijn maximaal 4100 tekens toegestaan.
tagslist of stringsOptionalDefaults to []

Optionele lijst met stijltags (bijv. [‘upbeat’, ‘cinematic’]). Er zijn maximaal 10 tags toegestaan.

model_idenumOptionalDefaults to music_v1
Het model dat voor de generatie moet worden gebruikt.
Allowed values:
add_sfxbooleanOptionalDefaults to false

Wanneer true, neem je SFX-signalen uit de video op.

separate_tracksbooleanOptionalDefaults to false

Wanneer true, retourneer je een ZIP met afzonderlijke audiotracks voor muziek en SFX in plaats van één gemixt bestand. Gebruik dit voor meer flexibiliteit bij het op elkaar leggen van tracks.

use_audio_as_referencebooleanOptionalDefaults to false
Wanneer true, analyseer je de audiotrack van de video en gebruik je genres, BPM, instrumentatie, sfeer en opbouw als referentiekenmerken voor het genereren van muziek.
sign_with_c2pabooleanOptionalDefaults to false

Of het gegenereerde nummer met C2PA moet worden ondertekend. Alleen van toepassing op mp3-bestanden.

Response headers

song-idstringOptional
Unieke identificatiecode voor het gegenereerde nummer

Response

Gegenereerd audiobestand dat bij de video past. Content-Type en bestandsextensie zijn afhankelijk van de parameter output_format (standaard mp3).

Errors

403
Forbidden Error
422
Unprocessable Entity Error