Przejdź do nawigacji
ElevenAPIMusic

Wideo na muzykę

Wygeneruj muzykę w tle z jednego lub kilku plików wideo. Filmy są łączone po kolei. Opcjonalny opis i tagi stylu wpływają na generowaną muzykę.

Nagłówki

xi-api-keystringOpcjonalny

Parametry zapytania

output_formatenumOpcjonalny

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_loggingbooleanOpcjonalnyDomyślnie true

Gdy enable_logging ma wartość false, dla żądania zostanie użyty tryb zerowej retencji. Z trybu zerowej retencji mogą korzystać tylko klienci Enterprise.

Żądanie

This endpoint expects a multipart form with multiple files.
videosfilesWymagany

Co najmniej jeden plik wideo wysłany w tablicy FormData (multipart/form-data). Zostaną połączone kolejno w jeden plik z kodekiem. Możesz przesłać maksymalnie 10 filmów, a łączny rozmiar połączonego wideo nie może przekroczyć 200 MB. Łącznie wideo może trwać do 600 sekund. Połączenie wielu filmów może znacznie wydłużyć czas żądania. Jeśli możesz, połącz je wcześniej.

descriptionstring or nullOpcjonalny1-4100 characters

Opcjonalny opis tekstowy muzyki, którą chcesz uzyskać. Maksymalnie 4100 znaków.

tagslist of stringsOpcjonalnyDomyślnie []

Opcjonalna lista tagów stylu (np. [‘upbeat’, ‘cinematic’]). Dozwolone jest maksymalnie 10 tagów.

model_idenumOpcjonalnyDomyślnie music_v1

Model do użycia przy generowaniu.

Dozwolone wartości:
add_sfxbooleanOpcjonalnyDomyślnie false

Gdy ma wartość true, uwzględnia wskazówki SFX z filmu.

separate_tracksbooleanOpcjonalnyDomyślnie false

Gdy ma wartość true, zwraca plik ZIP z osobnymi ścieżkami audio muzyki i SFX zamiast jednego zmiksowanego pliku. Użyj tej opcji, aby elastyczniej nakładać ścieżki.

use_audio_as_referencebooleanOpcjonalnyDomyślnie false

Gdy ma wartość true, analizuje ścieżkę audio filmu i wykorzystuje jej gatunki, BPM, instrumentację, nastrój oraz strukturę jako cechy referencyjne do generowania muzyki.

sign_with_c2pabooleanOpcjonalnyDomyślnie false

Czy podpisywać wygenerowany utwór za pomocą C2PA. Dotyczy tylko plików mp3.

Nagłówki odpowiedzi

song-idstringOpcjonalny
Unikalny identyfikator wygenerowanego utworu

Odpowiedź

Wygenerowany plik audio pasujący do filmu. Content-Type i rozszerzenie pliku zależą od parametru output_format (domyślnie mp3).

Błędy

403
Forbidden Error
422
Unprocessable Entity Error