Skip to navigation
ElevenAPIMusic

Gecomponeerde muziek met een gedetailleerd antwoord streamen

Stream een nummer en de gedetailleerde metadata ervan met Server-Sent Events (SSE).

Headers

xi-api-keystringOptional

Query parameters

output_formatenumOptionalDefaults to auto

Uitvoerformaat van de gegenereerde audio. Opgegeven als codec_sample_rate_bitrate. Gebruik “auto” (de standaardwaarde) om de API het beste formaat voor het geselecteerde model te laten kiezen: mp3_44100_128 voor v1-modellen en mp3_48000_192 voor v2-modellen.

Request

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

Een eenvoudige tekstprompt om een nummer mee te genereren. Kan niet worden gebruikt in combinatie met composition_plan.

composition_planobject or nullOptional

Een gedetailleerd compositieplan om de muziekgeneratie te sturen. Kan niet samen met prompt worden gebruikt.

music_length_msinteger or nullOptional3000-600000

De lengte van het te genereren nummer in milliseconden. Wordt alleen gebruikt in combinatie met prompt. Moet tussen 3000 ms en 600000 ms liggen. Optioneel: als je geen waarde opgeeft, kiest het model een lengte op basis van de prompt.

model_idenumOptionalDefaults to music_v1
Het model dat voor de generatie moet worden gebruikt.
Allowed values:
seedinteger or nullOptional0-2147483647
Willekeurige seed om het muziekgeneratieproces te initialiseren. Dezelfde seed met dezelfde parameters kan helpen om consistentere resultaten te behalen, maar exacte reproduceerbaarheid is niet gegarandeerd en uitvoer kan veranderen na systeemupdates. Kan niet samen met prompt worden gebruikt.
force_instrumentalbooleanOptionalDefaults to false

Als true, is het gegarandeerd dat het gegenereerde nummer instrumentaal is. Als false, kan het nummer afhankelijk van de prompt al dan niet instrumentaal zijn. Kan alleen met prompt worden gebruikt.

finetune_idstring or nullOptional<=100 characters
De ID van de finetune die voor de generatie moet worden gebruikt
store_for_inpaintingbooleanOptionalDefaults to false
Of het gegenereerde nummer voor inpainting moet worden opgeslagen.
with_timestampsbooleanOptionalDefaults to false
Of de tijdstempels van de woorden in het gegenereerde nummer moeten worden teruggestuurd.
with_waveform_visualbooleanOptionalDefaults to false
Of de visuele golfvorm van het gegenereerde nummer moet worden teruggestuurd.

Response headers

song-idstringOptional
Unieke identificatiecode voor het gegenereerde nummer

Response

Server-Sent Events voor het compositieplan, songmetadata, audiochunks met optionele woordtijdstempels en visuele golfvorm, en voltooiing.

Errors

422
Unprocessable Entity Error