Hoppa till navigering

Strömma komponerad musik med ett detaljerat svar

Streama en låt och dess detaljerade metadata med Server-Sent Events (SSE).

Headers

xi-api-keystringValfri

Frågeparametrar

output_formatenumValfriStandard är auto

Utdataformat för det genererade ljudet. Formateras som codec_sample_rate_bitrate. Använd "auto" (standardvärdet) för att låta API:et välja det bästa formatet för den valda modellen: mp3_44100_128 för v1-modeller och mp3_48000_192 för v2-modeller.

Förfrågan

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

En enkel textprompt att generera en låt från. Kan inte användas tillsammans med composition_plan.

composition_planobject or nullValfri

En detaljerad kompositionsplan som styr musikgenereringen. Kan inte användas tillsammans med prompt.

music_length_msinteger or nullValfri3000-600000

Längden på låten som ska genereras, i millisekunder. Används endast tillsammans med prompt. Måste vara mellan 3000 ms och 600000 ms. Valfritt – om inget anges väljer modellen en längd utifrån prompten.

model_idenumValfriStandard är music_v1

Modellen som ska användas för genereringen.

Tillåtna värden:
seedinteger or nullValfri0-2147483647

Slumpmässigt seed för att initiera musikgenereringsprocessen. Att ange samma seed med samma parametrar kan ge mer konsekventa resultat, men exakt reproducerbarhet garanteras inte och utdata kan ändras mellan systemuppdateringar. Kan inte användas tillsammans med prompt.

force_instrumentalbooleanValfriStandard är false

Om värdet är true garanteras att den genererade låten är instrumental. Om värdet är false kan låten vara instrumental eller inte, beroende på prompt. Kan endast användas med prompt.

finetune_idstring or nullValfri<=100 characters

ID:t för den Finetune som ska användas för genereringen

store_for_inpaintingbooleanValfriStandard är false

Om den genererade låten ska lagras för inpainting.

with_timestampsbooleanValfriStandard är false

Om tidsstämplarna för orden i den genererade låten ska returneras.

with_waveform_visualbooleanValfriStandard är false

Om den visuella vågformen för den genererade låten ska returneras.

Svarsheaders

song-idstringValfri

Unik identifierare för den genererade låten

Svar

Server-Sent Events för kompositionsplan, låtmetadata, ljudsegment med valfria ordtidsstämplar och visuell vågform samt slutförande.

Fel

422
Unprocessable Entity Error