Hoppa till navigering

Komponera musik

Komponera en låt utifrån en prompt eller en kompositionsplan.

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

respect_sections_durationsbooleanValfriStandard är true

Styr hur strikt sektionslängderna i composition_plan efterlevs. Används endast med composition_plan och gäller endast för music_v1; för music_v2 och music_v2_5 efterlevs sektionslängder alltid och detta ignoreras. När värdet är false för music_v1 kan modellen justera enskilda sektionslängder för bättre kvalitet och latens, samtidigt som låtens totala längd enligt planen bevaras.

store_for_inpaintingbooleanValfriStandard är false

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

sign_with_c2pabooleanValfriStandard är false

Om den genererade låten ska signeras med C2PA. Gäller endast mp3-filer.

Svarsheaders

song-idstringValfri

Unik identifierare för den genererade låten

Svar

Den genererade ljudfilen i det angivna formatet

Fel

422
Unprocessable Entity Error