Skip to navigation
ElevenAPIMusic

Muziek componeren

Componeer een nummer op basis van een prompt of compositieplan.

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
respect_sections_durationsbooleanOptionalDefaults to true

Controls how strictly section durations in the composition_plan are enforced. Only used with composition_plan and only applies to music_v1; for music_v2 and music_v2_5 section durations are always enforced and this is ignored. When false for music_v1, the model may adjust individual section durations for better quality and latency, while preserving the total song duration from the plan.

store_for_inpaintingbooleanOptionalDefaults to false
Of het gegenereerde nummer voor inpainting moet worden opgeslagen.
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

Het gegenereerde audiobestand in het opgegeven formaat

Errors

422
Unprocessable Entity Error