विस्तृत रिस्पॉन्स के साथ संगीत कंपोज़ करें

प्रॉम्प्ट या कंपोज़िशन प्लान से गाना बनाएं।

Headers

xi-api-keystringOptional

Query parameters

output_formatenumOptionalDefaults to auto
जनरेट किए गए ऑडियो का output format। codec_sample_rate_bitrate के रूप में फ़ॉर्मैट किया जाता है। चुने गए मॉडल के लिए API को सबसे अच्छा format चुनने देने हेतु "auto" (डिफ़ॉल्ट) का उपयोग करें: v1 models के लिए mp3_44100_128 और v2 models के लिए mp3_48000_192।

Request

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

गाना जनरेट करने के लिए एक सरल टेक्स्ट प्रॉम्प्ट। इसका उपयोग composition_plan के साथ नहीं किया जा सकता।

composition_planobject or nullOptional

संगीत जनरेशन को निर्देशित करने के लिए विस्तृत कंपोज़िशन प्लान। इसे prompt के साथ इस्तेमाल नहीं किया जा सकता।

music_length_msinteger or nullOptional3000-600000

जनरेट किए जाने वाले गाने की लंबाई, मिलीसेकंड में। केवल prompt के साथ इस्तेमाल होता है। यह 3000ms से 600000ms के बीच होनी चाहिए। वैकल्पिक — न देने पर मॉडल prompt के आधार पर लंबाई चुनेगा।

model_idenumOptionalDefaults to music_v1

जनरेशन के लिए इस्तेमाल किया जाने वाला मॉडल।

Allowed values:
seedinteger or nullOptional0-2147483647

म्यूज़िक जनरेशन प्रक्रिया शुरू करने के लिए रैंडम seed। समान पैरामीटर्स के साथ वही seed देने से अधिक सुसंगत नतीजे मिल सकते हैं, लेकिन एकदम समान परिणाम की गारंटी नहीं है और सिस्टम अपडेट के बीच आउटपुट बदल सकते हैं। prompt के साथ इस्तेमाल नहीं किया जा सकता।

force_instrumentalbooleanOptionalDefaults to false

अगर true है, तो जनरेट किया गया गाना इंस्ट्रूमेंटल होना सुनिश्चित करता है। अगर false है, तो prompt के आधार पर गाना इंस्ट्रूमेंटल हो भी सकता है और नहीं भी। इसका उपयोग केवल prompt के साथ किया जा सकता है।

finetune_idstring or nullOptional<=100 characters

जनरेशन के लिए उपयोग किए जाने वाले Finetune की ID

respect_sections_durationsbooleanOptionalDefaults to true

composition_plan में सेक्शन की अवधि को कितनी सख्ती से लागू किया जाए, यह नियंत्रित करता है। यह केवल composition_plan के साथ इस्तेमाल होता है और सिर्फ़ music_v1 पर लागू होता है; music_v2 और music_v2_5 में सेक्शन की अवधि हमेशा लागू होती है और इसे अनदेखा किया जाता है। music_v1 के लिए false होने पर, मॉडल बेहतर गुणवत्ता और लेटेंसी के लिए अलग-अलग सेक्शन की अवधि बदल सकता है, जबकि प्लान में दी गई कुल गाने की अवधि बरकरार रखता है।

store_for_inpaintingbooleanOptionalDefaults to false

इनपेंटिंग के लिए जनरेट किया गया गाना स्टोर करना है या नहीं।

with_timestampsbooleanOptionalDefaults to false

जनरेट किए गए गाने के शब्दों के टाइमस्टैम्प लौटाने हैं या नहीं।

with_waveform_visualbooleanOptionalDefaults to false

जनरेट किए गए गाने का विज़ुअल वेवफ़ॉर्म लौटाना है या नहीं।

sign_with_c2pabooleanOptionalDefaults to false

जनरेट किए गए गाने पर C2PA साइन करना है या नहीं। केवल mp3 फ़ाइलों पर लागू।

Response headers

song-idstringOptional

जनरेट किए गए गाने का विशिष्ट पहचानकर्ता

Response

JSON मेटाडेटा और बाइनरी ऑडियो फ़ाइल के साथ मल्टीपार्ट/मिक्स्ड रिस्पॉन्स

Errors

422
Unprocessable Entity Error