> 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.
### Music v2 पेश है
Music v2 अब ElevenLabs API के ज़रिए उपलब्ध है। नया मॉडल इस्तेमाल करने के लिए [म्यूज़िक जनरेट करें](/docs/hi/api-reference/music/compose), [म्यूज़िक स्ट्रीम करें](/docs/hi/api-reference/music/stream), [विस्तृत म्यूज़िक जनरेट करें](/docs/hi/api-reference/music/compose-detailed) और [म्यूज़िक अपलोड करें](/docs/hi/api-reference/music/upload) में `model_id` को `music_v2` पर सेट करें। Music v2 में `GenerationChunk` और `AudioRefChunk` सेगमेंट्स से बने चंक-आधारित कंपोज़िशन प्लान हैं, जो आपको प्रॉम्प्ट-आधारित `music_v1` फ़्लो की तुलना में संरचना, गति और अरेंजमेंट पर बेहतर नियंत्रण देते हैं।
जनरेशन और अपलोड रिक्वेस्ट्स में `music_v2` कंपोज़िशन प्लान इस्तेमाल करें, या पहले कंपोज़िशन-प्लान एंडपॉइंट के ज़रिए प्लान जनरेट करें। रिक्वेस्ट और रिस्पॉन्स बॉडीज़ v1 या v2, दोनों प्लान शेप्स स्वीकार करती हैं, इसलिए आप हर एंडपॉइंट के हिसाब से माइग्रेट कर सकते हैं। `MusicPrompt` सिर्फ़ `music_v1` के लिए उपलब्ध रहता है।
Music API के साथ कुछ ही मिनटों में अपना पहला ट्रैक जनरेट करें।
व्यवस्थित, कई सेक्शन वाले ट्रैक्स के लिए चंक-आधारित कंपोज़िशन प्लान बनाएं।
REST API के ज़रिए `music_v2` के साथ म्यूज़िक कंपोज़, स्ट्रीम और अपलोड करें।
- **अपलोड टाइमस्टैंप्स**: [म्यूज़िक अपलोड करें](/docs/hi/api-reference/music/upload) वैकल्पिक `with_timestamps` स्वीकार करता है; रिस्पॉन्स में `words_timestamps` शामिल हो सकते हैं।
### ElevenAgents
- **कन्वर्सेशन इवैल्यूएशन चलाएं**: पूरे हो चुके कन्वर्सेशन पर `RunConversationEvaluationsRequest` का उपयोग करके एक इवैल्यूएशन क्राइटेरिया फिर से चलाने के लिए [कन्वर्सेशन इवैल्यूएशन चलाएं](/docs/hi/api-reference/conversations/analysis/run-evaluation) एंडपॉइंट (`POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run`) जोड़ा गया।
- **वर्कफ़्लो एंट्री व्यवहार**: वर्कफ़्लो ओवरराइड-एजेंट नोड्स में सब-एजेंट पहले बोलेगा या यूज़र इनपुट का इंतज़ार करेगा, इसे नियंत्रित करने के लिए वैकल्पिक `entry_behavior` (`generate_immediately`, `wait_for_user`, `auto`) जोड़ा गया है।
- **एंड प्रोसीजर सिस्टम टूल**: मिलते-जुलते एरर स्टेटस के साथ `end_procedure` सिस्टम टूल कॉन्फ़िगरेशन जोड़ा गया। `start_procedure` टूल के एरर स्टेटस में `already_active` जोड़ा गया है।
- **ट्रांसफ़र TTS ओवरराइड्स**: `AgentTransfer`, वर्कफ़्लो स्टैंडअलोन एजेंट नोड्स और सफल `transfer_to_agent` टूल रिज़ल्ट्स में ट्रांसफ़र के बाद क्लाइंट-साइड TTS ओवरराइड्स बनाए रखने के लिए वैकल्पिक `preserve_client_tts_overrides` (बूलियन) जोड़ा गया है।
- **इंटरैक्शन बजट enum**: `InteractionBudget` से `async` हटाया गया है और `5_minutes`, `10_minutes` व `1_hour` जोड़े गए हैं। उन सभी कॉन्फ़िग्स या SDK enums को अपडेट करें जिनमें अभी भी `async` का उल्लेख है।
- **कस्टम गार्डरेल मॉडल चयन**: कस्टम गार्डरेल कॉन्फ़िगरेशन में Gemini, Claude और GPT वेरिएंट्स के साथ वैकल्पिक `model` जोड़ा गया है। गार्डरेल कॉन्फ़िग में वैकल्पिक `history_message_count` (पूर्णांक) भी जोड़ा गया है।
- **फ़ोन नंबर लिस्ट फ़िल्टर्स**: इंपोर्ट किए गए नंबरों को फ़िल्टर करने के लिए [फ़ोन नंबरों की सूची पाएं](/docs/hi/api-reference/phone-numbers/list) में वैकल्पिक `provider`, `agent_id` और `branch_id` क्वेरी पैरामीटर्स जोड़े गए हैं।
- **WhatsApp अकाउंट फ़िल्टरिंग**: असाइन किए गए एजेंट के आधार पर अकाउंट्स फ़िल्टर करने के लिए [WhatsApp अकाउंट्स की सूची पाएं](/docs/hi/api-reference/whats-app/accounts/list) में वैकल्पिक `agent_id` क्वेरी पैरामीटर जोड़ा गया है।
- **टॉपिक टाइम रेंज फ़िल्टर्स**: टॉपिक डिस्कवरी रिज़ल्ट्स को सीमित करने के लिए [एजेंट कन्वर्सेशन टॉपिक्स पाएं](/docs/hi/api-reference/conversations/topics/get) में वैकल्पिक `from_unix_secs` और `to_unix_secs` क्वेरी पैरामीटर्स जोड़े गए हैं।
- **SIP कोडेक कॉन्फ़िगरेशन**: आउटबाउंड SIP ट्रंक रिक्वेस्ट और रिस्पॉन्स मॉडल्स में वैकल्पिक `enabled_codecs` (`MediaCodec` enum) जोड़ा गया है।
- **मेमोरी टूल टाइप्स**: मेमोरी-टूल एरर हैंडलिंग के लिए `LoadableMemoryEntry` और `LoadMemoryEntryToolErrorStatus` स्कीमाएँ जोड़ी गईं।
- **एजेंट टेस्ट बैच सीमाएँ**: एजेंट टेस्ट attach, run और resubmit रिक्वेस्ट स्कीमाओं में अटैच किए जा सकने वाले टेस्ट्स की अधिकतम सीमा 1000 से बढ़ाकर 5000 की गई।
- **फ़ोनीम टैग सपोर्ट**: ऑप्ट-इन V3 SSML फ़ोनीम हैंडलिंग के लिए एजेंट TTS सेटिंग्स में वैकल्पिक `enable_phoneme_tags` (बूलियन) जोड़ा गया है।
- **ऐरे स्कीमा ओमिट ओवरराइड्स**: ऐरे JSON स्कीमा प्रॉपर्टीज़ में वैकल्पिक `is_omitted` (अन्य वैल्यू सोर्सेज़ के साथ म्यूचुअली एक्सक्लूसिव) जोड़ा गया है। `ConstantSchemaOverride` ऐरे कॉन्स्टेंट वैल्यूज़ का उपयोग कर सकता है।
- **ट्रांसफ़र एरर कॉन्टेक्स्ट**: नंबर पर ट्रांसफ़र करने के एरर पेलोड्स में वैकल्पिक `agent_message` (स्ट्रिंग) शामिल हो सकता है।
### वर्कस्पेसेस
- **सर्विस अकाउंट API की अपडेट्स**: [सर्विस अकाउंट API की अपडेट करें](/docs/hi/api-reference/service-accounts/api-keys/update) में अब रिक्वेस्ट बॉडी की ज़रूरत नहीं है। एडिट फ़ील्ड्स `no_update` और nullable `name` के ज़रिए आंशिक अपडेट्स सपोर्ट करते हैं, जिनमें `permissions` और `character_limit` शामिल हैं।
- **उपयोग टाइमज़ोन बकेटिंग**: वर्कस्पेस usage-by-product-over-time रिक्वेस्ट्स में स्पष्ट `interval_seconds` बकेट नियमों के साथ वैकल्पिक `time_zone` (IANA टाइमज़ोन स्ट्रिंग) जोड़ा गया है।
- **हिस्ट्री सोर्स फ़िल्टर**: हिस्ट्री लिस्ट और डिटेल `source` फ़िल्टर्स में `Flows` जोड़ा गया है।
### ElevenCreative Studio
- **प्रोजेक्ट वॉइस रेफरेंसेस**: प्रोजेक्ट मॉडल्स, चैप्टर TTS नोड्स, वॉइस लिस्ट्स और वॉइस स्टैटिस्टिक्स में कैनॉनिकल वॉइस फ़ील्ड के रूप में `project_voice_ref_id` अपनाया गया है। पुराने `voice_id` फ़ील्ड्स कंपैटिबिलिटी के लिए अप्रचलित, रीड-ओनली मिरर्स के रूप में रिस्पॉन्स में बने रहेंगे।
### स्पीच टू टेक्स्ट
- **स्पीकर लाइब्रेरी डायराइज़ेशन**: बैच ट्रांसक्रिप्शन डायराइज़ेशन के लिए [स्पीच को टेक्स्ट में बदलें](/docs/hi/api-reference/speech-to-text/convert) में वैकल्पिक `use_speaker_library` (बूलियन, डिफ़ॉल्ट `false`) जोड़ा गया है।
### वॉइसेस
- **शेयर्ड वॉइस सॉर्टिंग**: [शेयर्ड वॉइसेस की सूची पाएं](/docs/hi/api-reference/voices/voice-library/get-shared) के `sort` क्वेरी पैरामीटर में स्पष्ट enum, `created_date` डिफ़ॉल्ट और अपडेट किया गया विवरण जोड़ा गया है।
### SDK रिलीज़
#### JavaScript SDK
- [v2.53.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.53.0) - नवीनतम OpenAPI स्कीमा से फिर से जनरेट किया गया। इसमें कन्वर्सेशन इवैल्यूएशन को फिर से चलाने का सपोर्ट, Music v2 कंपोज़िशन-प्लान यूनियन्स, वर्कफ़्लो `entry_behavior`, फ़ोन नंबर और WhatsApp लिस्ट फ़िल्टर्स, टॉपिक टाइम-रेंज पैरामीटर्स, अलर्टिंग स्कीमा अपडेट्स, स्टूडियो `project_voice_ref_id` फ़ील्ड्स और विस्तारित एजेंट टेस्ट बैच सीमाएँ शामिल हैं।
#### Python SDK
- [v2.53.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.53.0) - नवीनतम OpenAPI स्कीमा से फिर से जनरेट किया गया। इसमें कन्वर्सेशन इवैल्यूएशन को फिर से चलाने का सपोर्ट, Music v2 कंपोज़िशन प्लान्स, वर्कफ़्लो एंट्री व्यवहार और एंड-प्रोसीजर टूल्स, टेलीफ़ोनी फ़िल्टर पैरामीटर्स, अलर्टिंग और सर्विस-अकाउंट आंशिक-अपडेट मॉडल्स, और स्टूडियो वॉइस रेफरेंस फ़ील्ड्स शामिल हैं।
#### पैकेजेस
- [@elevenlabs/client@1.11.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.11.0) - Unity SDK WebGL ब्रिज के लिए `@elevenlabs/client/internal/unity` सब-पाथ एक्सपोर्ट जोड़ा गया, जो `MediaDeviceInput`, `MediaDeviceOutput`, कनेक्शन attach हेल्पर्स और WebRTC अडैप्टर टाइप्स एक्सपोज़ करता है।
- [@elevenlabs/client@1.11.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.11.1), [@elevenlabs/react@1.6.7](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.6.7), [@elevenlabs/react-native@1.2.7](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.7), [@elevenlabs/convai-widget-core@0.14.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.2) और [@elevenlabs/convai-widget-embed@0.14.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.2) - `@elevenlabs/client@1.11.1` और `@elevenlabs/types@0.14.1` के साथ डिपेंडेंसी अलाइनमेंट।
- [@elevenlabs/types@0.14.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.14.1) - लाइसेंस-चेकर कंपैटिबिलिटी के लिए `package.json` में `"license": "MIT"` जोड़ा गया।
#### iOS SDK
- [v3.2.1](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.2.1) - Singapore डेटा रेज़िडेंसी सपोर्ट जोड़ा गया और WebRTC सेशंस के लिए `singlePeerConnection` सक्षम किया गया।
### API
## नए एंडपॉइंट्स
### ElevenAgents
- [कन्वर्सेशन इवैल्यूएशन चलाएं](/docs/hi/api-reference/conversations/analysis/run-evaluation) - `POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run`
- एक इवैल्यूएशन क्राइटेरिया फिर से चलाने के लिए रिक्वेस्ट बॉडी में `RunConversationEvaluationsRequest` का उपयोग होता है
## अपडेट किए गए एंडपॉइंट्स
### ElevenAgents
- [फ़ोन नंबरों की सूची पाएं](/docs/hi/api-reference/phone-numbers/list) - `GET /v1/convai/phone-numbers`
- वैकल्पिक `provider`, `agent_id` और `branch_id` क्वेरी पैरामीटर्स जोड़े गए
- [एजेंट कन्वर्सेशन टॉपिक्स पाएं](/docs/hi/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
- वैकल्पिक `from_unix_secs` और `to_unix_secs` क्वेरी पैरामीटर्स जोड़े गए
- [WhatsApp अकाउंट्स की सूची पाएं](/docs/hi/api-reference/whats-app/accounts/list) - `GET /v1/convai/whatsapp-accounts`
- वैकल्पिक `agent_id` क्वेरी पैरामीटर जोड़ा गया
### म्यूज़िक
- [म्यूज़िक जनरेट करें](/docs/hi/api-reference/music/compose), [विस्तृत म्यूज़िक जनरेट करें](/docs/hi/api-reference/music/compose-detailed), [म्यूज़िक स्ट्रीम करें](/docs/hi/api-reference/music/stream) और [म्यूज़िक अपलोड करें](/docs/hi/api-reference/music/upload)
- समर्थित `model_id` वैल्यूज़ में `music_v2` जोड़ा गया
- अपलोड में वैकल्पिक `with_timestamps` जोड़ा गया; रिस्पॉन्स में `words_timestamps` शामिल हो सकते हैं
### स्पीच टू टेक्स्ट
- [स्पीच को टेक्स्ट में बदलें](/docs/hi/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text`
- वैकल्पिक `use_speaker_library` क्वेरी पैरामीटर (बूलियन, डिफ़ॉल्ट `false`) जोड़ा गया
### वॉइसेस
- [शेयर्ड वॉइसेस की सूची पाएं](/docs/hi/api-reference/voices/voice-library/get-shared) - `GET /v1/shared-voices`
- `sort` क्वेरी पैरामीटर अब `created_date` डिफ़ॉल्ट वाले स्पष्ट enum का उपयोग करता है
## स्कीमा बदलाव
### ElevenAgents
- वर्कफ़्लो ओवरराइड-एजेंट नोड्स
- वैकल्पिक `entry_behavior` enum (`generate_immediately`, `wait_for_user`, `auto`) जोड़ा गया
- सिस्टम टूल्स
- `end_procedure` टूल कॉन्फ़िग और एरर स्टेटस जोड़े गए
- ट्रांसफ़र और इंटरैक्शन स्कीमाएँ
- ट्रांसफ़र्स और ट्रांसफ़र टूल रिज़ल्ट्स पर वैकल्पिक `preserve_client_tts_overrides` जोड़ा गया
- `InteractionBudget` से `async` हटाया गया; `5_minutes`, `10_minutes`, `1_hour` जोड़े गए
- गार्डरेल्स और TTS
- कस्टम गार्डरेल्स में वैकल्पिक `model` और `history_message_count` जोड़े गए
- एजेंट TTS सेटिंग्स में वैकल्पिक `enable_phoneme_tags` जोड़ा गया
- टेलीफ़ोनी
- SIP ट्रंक मॉडल्स में वैकल्पिक `enabled_codecs` (`MediaCodec` enum) जोड़ा गया
- मेमोरी और कोड टूल्स
- `LoadableMemoryEntry` और `LoadMemoryEntryToolErrorStatus` जोड़े गए
- एजेंट टेस्टिंग
- run और resubmit रिक्वेस्ट्स पर अटैच किए गए टेस्ट की सीमा 1000 से बढ़ाकर 5000 की गई
- टूल JSON स्कीमा प्रॉपर्टीज़
- ऐरे प्रॉपर्टीज़ में वैकल्पिक `is_omitted` जोड़ा गया
### वर्कस्पेसेस
- सर्विस अकाउंट्स
- API की PATCH, `no_update` सेंटिनल्स के साथ आंशिक अपडेट्स सपोर्ट करता है
- उपयोग और हिस्ट्री
- usage-by-product-over-time में वैकल्पिक `time_zone` जोड़ा गया
- हिस्ट्री `source` फ़िल्टर्स में `Flows` जोड़ा गया
### म्यूज़िक
- कंपोज़िशन प्लान्स
- `music_v2` के लिए चंक-आधारित `CompositionPlan`, `GenerationChunk` और `AudioRefChunk` जोड़े गए
- रिक्वेस्ट और रिस्पॉन्स बॉडीज़ v1 या v2 प्लान शेप्स का `anyOf` स्वीकार करती हैं
### ElevenCreative Studio
- प्रोजेक्ट वॉइस मॉडल्स
- कैनॉनिकल वॉइस रेफरेंस के रूप में `project_voice_ref_id` जोड़ा गया
- अप्रचलित रीड-ओनली `voice_id` मिरर्स रिस्पॉन्स में बनाए रखे गए