ElevenAPIMusic

Strumieniuj skomponowaną muzykę ze szczegółową odpowiedzią

Strumieniuj utwór i jego szczegółowe metadane za pomocą Server-Sent Events (SSE).

Nagłówki

xi-api-keystringOpcjonalny

Parametry zapytania

output_formatenumOpcjonalnyDomyślnie auto

Format wyjściowy wygenerowanego audio. Ma postać codec_sample_rate_bitrate. Użyj “auto” (domyślne), aby API wybrało najlepszy format dla wybranego modelu: mp3_44100_128 dla modeli v1 i mp3_48000_192 dla modeli v2.

Żądanie

This endpoint expects an object.
promptstring or nullOpcjonalny<=4100 characters

Prosty prompt tekstowy do wygenerowania utworu. Nie można go używać razem z composition_plan.

composition_planobject or nullOpcjonalny

Szczegółowy plan kompozycji sterujący generowaniem muzyki. Nie można go używać razem z prompt.

music_length_msinteger or nullOpcjonalny3000-600000

Długość generowanego utworu w milisekundach. Używane tylko z prompt. Musi wynosić od 3000 ms do 600000 ms. Opcjonalne — jeśli nie podano, model wybierze długość na podstawie promptu.

model_idenumOpcjonalnyDomyślnie music_v1

Model do użycia przy generowaniu.

Dozwolone wartości:
seedinteger or nullOpcjonalny0-2147483647

Losowy seed inicjujący generowanie muzyki. Użycie tego samego seedu z tymi samymi parametrami może dać bardziej spójne wyniki, ale dokładna powtarzalność nie jest gwarantowana, a wyniki mogą się zmieniać po aktualizacjach systemu. Nie można używać razem z prompt.

force_instrumentalbooleanOpcjonalnyDomyślnie false

Jeśli ma wartość true, gwarantuje, że wygenerowany utwór będzie instrumentalny. Jeśli ma wartość false, utwór może być instrumentalny lub nie, zależnie od prompt. Można używać tylko z prompt.

finetune_idstring or nullOpcjonalny<=100 characters

ID Finetune do użycia w generacji

store_for_inpaintingbooleanOpcjonalnyDomyślnie false

Czy przechowywać wygenerowany utwór do inpaintingu.

with_timestampsbooleanOpcjonalnyDomyślnie false

Czy zwracać znaczniki czasu słów w wygenerowanym utworze.

with_waveform_visualbooleanOpcjonalnyDomyślnie false

Czy zwracać wizualną formę fali wygenerowanego utworu.

Nagłówki odpowiedzi

song-idstringOpcjonalny
Unikalny identyfikator wygenerowanego utworu

Odpowiedź

Zdarzenia Server-Sent Events dla planu kompozycji, metadanych utworu, fragmentów audio z opcjonalnymi znacznikami czasu słów i wizualną falą dźwiękową oraz zakończenia.

Błędy

422
Unprocessable Entity Error