> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # विस्तृत रिस्पॉन्स के साथ कंपोज़ किया गया संगीत स्ट्रीम करें POST https://api.elevenlabs.io/v1/music/detailed/stream Content-Type: application/json Server-Sent Events (SSE) का उपयोग करके गीत और उसका विस्तृत मेटाडेटा स्ट्रीम करें। Reference: https://elevenlabs.io/docs/api-reference/music/compose-detailed-stream ## Servers - `https://api.elevenlabs.io` (Production, default) - `https://api.us.elevenlabs.io` (Production US) - `https://api.eu.residency.elevenlabs.io` (Production EU) - `https://api.in.residency.elevenlabs.io` (Production India) - `https://api.sg.residency.elevenlabs.io` (Production Singapore) ## Request ### Query parameters - `output_format` (enum, optional, default: auto) — जनरेट किए गए ऑडियो का output format। codec_sample_rate_bitrate के रूप में फ़ॉर्मैट किया जाता है। चुने गए मॉडल के लिए API को सबसे अच्छा format चुनने देने हेतु "auto" (डिफ़ॉल्ट) का उपयोग करें: v1 models के लिए mp3_44100_128 और v2 models के लिए mp3_48000_192। - Allowed values: `auto`, `mp3_48000_128`, `mp3_48000_192`, `mp3_48000_240`, `mp3_48000_320`, `mp3_22050_32`, `mp3_24000_48`, `mp3_44100_32`, `mp3_44100_64`, `mp3_44100_96`, `mp3_44100_128`, `mp3_44100_192`, `pcm_8000`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_32000`, `pcm_44100`, `pcm_48000`, `ulaw_8000`, `alaw_8000`, `opus_48000_32`, `opus_48000_64`, `opus_48000_96`, `opus_48000_128`, `opus_48000_192` - `enable_logging` (boolean, optional, default: true) — जब enable_logging को false पर सेट किया जाता है, तो अनुरोध के लिए ज़ीरो रिटेंशन मोड इस्तेमाल होगा। ज़ीरो रिटेंशन मोड का इस्तेमाल सिर्फ़ एंटरप्राइज़ ग्राहक कर सकते हैं। ### Body (application/json) This endpoint expects a Body_Stream_composed_music_with_a_detailed_response_v1_music_detailed_stream_post. - `prompt` (string, optional, nullable) — गाना जनरेट करने के लिए एक सरल टेक्स्ट प्रॉम्प्ट। इसका उपयोग `composition_plan` के साथ नहीं किया जा सकता। - `composition_plan` (BodyStreamComposedMusicWithADetailedResponseV1MusicDetailedStreamPostCompositionPlan, optional, nullable) — संगीत जनरेशन को निर्देशित करने के लिए विस्तृत कंपोज़िशन प्लान। इसे `prompt` के साथ इस्तेमाल नहीं किया जा सकता। - `music_length_ms` (integer, optional, nullable) — जनरेट किए जाने वाले गाने की लंबाई, मिलीसेकंड में। केवल `prompt` के साथ इस्तेमाल होता है। यह 3000ms से 600000ms के बीच होनी चाहिए। वैकल्पिक — न देने पर मॉडल prompt के आधार पर लंबाई चुनेगा। - `model_id` (enum, optional, default: music_v1) — जनरेशन के लिए इस्तेमाल किया जाने वाला मॉडल। - Allowed values: `music_v1`, `music_v2`, `music_v2_5` - `seed` (integer, optional, nullable) — म्यूज़िक जनरेशन प्रक्रिया शुरू करने के लिए रैंडम seed। समान पैरामीटर्स के साथ वही seed देने से अधिक सुसंगत नतीजे मिल सकते हैं, लेकिन एकदम समान परिणाम की गारंटी नहीं है और सिस्टम अपडेट के बीच आउटपुट बदल सकते हैं। prompt के साथ इस्तेमाल नहीं किया जा सकता। - `force_instrumental` (boolean, optional, default: false) — अगर true है, तो जनरेट किया गया गाना इंस्ट्रूमेंटल होना सुनिश्चित करता है। अगर false है, तो `prompt` के आधार पर गाना इंस्ट्रूमेंटल हो भी सकता है और नहीं भी। इसका उपयोग केवल `prompt` के साथ किया जा सकता है। - `finetune_id` (string, optional, nullable) — जनरेशन के लिए उपयोग किए जाने वाले Finetune की ID - `store_for_inpainting` (boolean, optional, default: false) — इनपेंटिंग के लिए जनरेट किया गया गाना स्टोर करना है या नहीं। - `with_timestamps` (boolean, optional, default: false) — जनरेट किए गए गाने के शब्दों के टाइमस्टैम्प लौटाने हैं या नहीं। - `with_waveform_visual` (boolean, optional, default: false) — जनरेट किए गए गाने का विज़ुअल वेवफ़ॉर्म लौटाना है या नहीं। ## Response ### 200 composition plan, song metadata, वैकल्पिक word timestamps और visual waveform वाले audio chunks, और completion के लिए Server-Sent Events। - Streaming response of `string`. ## Errors ### 422 Unprocessable Entity Error वैलिडेशन एरर - `detail` (list of ValidationError, optional) ## Types ### BodyStreamComposedMusicWithADetailedResponseV1MusicDetailedStreamPostCompositionPlan संगीत जनरेशन को निर्देशित करने के लिए विस्तृत कंपोज़िशन प्लान। इसे `prompt` के साथ इस्तेमाल नहीं किया जा सकता। ### ValidationError - `loc` (list of ValidationErrorLocItems, required) - `msg` (string, required) - `type` (string, required) ### MusicPrompt `music_v1` मॉडल के लिए कंपोज़िशन प्लान। किसी अन्य मॉडल के साथ इस फ़ील्ड का इस्तेमाल करने पर एरर आएगा। - `positive_global_styles` (list of string, required) — वे स्टाइल और म्यूज़िकल निर्देश जो पूरे गाने में होने चाहिए। बेहतर नतीजों के लिए अंग्रेज़ी का इस्तेमाल करें। - `negative_global_styles` (list of string, required) — वे स्टाइल और म्यूज़िकल निर्देश जो पूरे गाने में नहीं होने चाहिए। बेहतर नतीजों के लिए अंग्रेज़ी का इस्तेमाल करें। - `sections` (list of SongSection, required) — गाने के सेक्शन्स। ### CompositionPlan `music_v2` और `music_v2_5` मॉडल के लिए कंपोज़िशन प्लान। किसी अन्य मॉडल के साथ इस फ़ील्ड का इस्तेमाल करने पर एरर आएगा। - `chunks` (list of CompositionPlanChunksItems, required) — जनरेशन बनाने वाले चंक्स। ### ValidationErrorLocItems ### SongSection - `section_name` (string, required) — सेक्शन का नाम। यह 1 से 100 वर्णों के बीच होना चाहिए। - `positive_local_styles` (list of string, required) — वे स्टाइल और म्यूज़िकल निर्देश जो इस सेक्शन में होने चाहिए। बेहतर नतीजों के लिए अंग्रेज़ी का इस्तेमाल करें। - `negative_local_styles` (list of string, required) — वे स्टाइल और म्यूज़िकल निर्देश जो इस सेक्शन में नहीं होने चाहिए। बेहतर नतीजों के लिए अंग्रेज़ी का इस्तेमाल करें। - `duration_ms` (integer, required) — सेक्शन की अवधि मिलीसेकंड में। यह 3000ms और 120000ms के बीच होनी चाहिए। - `lines` (list of string, required) — सेक्शन के बोल। हर सेक्शन में अधिकतम 30 पंक्तियां और हर पंक्ति में अधिकतम 200 वर्ण हो सकते हैं। - `source_from` (SectionSource, optional, nullable) — section निकालने के लिए वैकल्पिक source। inpainting के लिए इस्तेमाल होता है। ### CompositionPlanChunksItems ### SectionSource - `song_id` (string, required) — उस गाने की ID जिससे सेक्शन लेना है। गाना जनरेट करते समय आप रिस्पॉन्स हेडर में गाने की ID पा सकते हैं। - `range` (TimeRange, required) — स्रोत गाने से निकालने की रेंज। - `negative_ranges` (list of TimeRange, optional) — 'range' से बाहर रखने वाली रेंजेस। ### GenerationChunk-Input - `text` (string, required) — इस चंक के लिए जनरेट किया जाने वाला टेक्स्ट कॉन्फ़िगरेशन। इसमें शुरुआत में स्क्वेयर ब्रैकेट में वैकल्पिक सेक्शन नाम, जैसे \[Verse 1], लिरिक्स की लाइनें और कर्ली ब्रेसेस में इनलाइन निर्देश, जैसे \{scratching}, शामिल हो सकते हैं। सेक्शन नाम 1 से 100 कैरेक्टर के बीच होना चाहिए। अधिकतम 30 लाइनें स्वीकार्य हैं और हर लाइन अधिकतम 200 कैरेक्टर की हो सकती है। - `duration_ms` (integer, required) — चंक की अवधि मिलीसेकंड में। यह 3000ms और 120000ms के बीच होनी चाहिए। - `positive_styles` (list of string, required) — वे स्टाइल और म्यूज़िकल निर्देश जो इस चंक में होने चाहिए। बेहतर नतीजों के लिए अंग्रेज़ी का इस्तेमाल करें। पहले चंक की स्टाइल सबसे महत्वपूर्ण होती हैं, क्योंकि वे गाने का समग्र टोन और जॉनर तय करती हैं। बाद के चंक्स की स्टाइल से बारीकियां, प्रगति या ज़ोर जोड़ा जा सकता है, या गाने की दिशा बदली जा सकती है। दिशा तय होने तक शुरुआती चंक्स में कम से कम 6-7 स्टाइल रखने का लक्ष्य रखें। 'great production quality' जैसी सामान्य स्टाइल सूची में जोड़ने के लिए अच्छे डिफ़ॉल्ट विकल्प हैं। - `negative_styles` (list of string, optional) — वे स्टाइल और म्यूज़िकल निर्देश जो इस चंक में नहीं होने चाहिए। बेहतर नतीजों के लिए अंग्रेज़ी का इस्तेमाल करें। इसे खाली छोड़ना अच्छा डिफ़ॉल्ट है; इस फ़ील्ड का इस्तेमाल केवल तब करें, जब आप किसी खास स्टाइल या दिशा से स्पष्ट रूप से बचना चाहते हों। - `context_adherence` (enum, optional, default: high) — मॉडल अपने आसपास के चंक के कॉन्टेक्स्ट का कितना पालन करता है। कम पालन का मतलब है कि मॉडल कॉन्टेक्स्ट से हटकर ज़्यादा रचनात्मक हो सकता है। ज़्यादा पालन का मतलब है कि मॉडल कॉन्टेक्स्ट के साथ ज़्यादा सुसंगत रहेगा। - Allowed values: `low`, `medium`, `high` - `conditioning_ref` (AudioRefChunk, optional, nullable) — जनरेशन को कंडीशन करने के लिए ऑडियो रेफ़रेंस। पहला चंक सबसे महत्वपूर्ण है, क्योंकि यह बाद के सभी चंक्स की जनरेशन को प्रभावित करेगा। इसलिए, अगर आप पूरे गाने पर कंडीशनिंग लागू करना चाहते हैं, तो पहले चंक से शुरू करें। - `condition_strength` (enum, optional, nullable) — मॉडल कंडीशनिंग रेफ़रेंस का कितनी मज़बूती से पालन करता है। कम स्ट्रेंथ का मतलब है कि मॉडल ज़्यादा रचनात्मक होगा और रेफ़रेंस से हटेगा। ज़्यादा स्ट्रेंथ का मतलब है कि मॉडल रेफ़रेंस के साथ ज़्यादा सुसंगत रहेगा। - Allowed values: `low`, `medium`, `high`, `xhigh` ### AudioRefChunk - `song_id` (string, required) — उस गाने की ID जिससे चंक लेना है। गाना जनरेट करते समय आप रिस्पॉन्स हेडर में गाने की ID पा सकते हैं। - `range` (TimeRange, required) — गाने से निकालने के लिए समय-सीमा। ### TimeRange - `start_ms` (integer, required) - `end_ms` (integer, required) ## Examples **Request** ```json {} ``` **Response** ```json [ "string" ] ``` **SDK Code** ```python import requests url = "https://api.elevenlabs.io/v1/music/detailed/stream" payload = {} headers = {"Content-Type": "application/json"} response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.elevenlabs.io/v1/music/detailed/stream'; const options = {method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{}'}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.elevenlabs.io/v1/music/detailed/stream" payload := strings.NewReader("{}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.elevenlabs.io/v1/music/detailed/stream") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Content-Type"] = 'application/json' request.body = "{}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.elevenlabs.io/v1/music/detailed/stream") .header("Content-Type", "application/json") .body("{}") .asString(); ``` ```php request('POST', 'https://api.elevenlabs.io/v1/music/detailed/stream', [ 'body' => '{}', 'headers' => [ 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.elevenlabs.io/v1/music/detailed/stream"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Content-Type": "application/json"] let parameters = [] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.elevenlabs.io/v1/music/detailed/stream")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```