> 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. # त्रुटियां ## API त्रुटियां ElevenLabs किसी अनुरोध की सफलता या विफलता बताने के लिए मानक HTTP स्टेटस कोड का उपयोग करता है। साथ ही, सभी API अनुरोध एक JSON ऑब्जेक्ट लौटाते हैं, जिसमें `detail` प्रॉपर्टी होती है और उसमें त्रुटि की जानकारी होती है। आम तौर पर, `200` HTTP स्टेटस कोड सफल अनुरोध दर्शाता है। `4xx` कोड अनुरोध में किसी समस्या को दर्शाता है, जैसे अमान्य पैरामीटर या आवश्यक फ़ील्ड का न होना। `500` HTTP स्टेटस कोड ElevenLabs के सर्वर में किसी समस्या को दर्शाता है, जो बहुत कम ही होनी चाहिए। ### त्रुटि प्रॉपर्टीज़ | प्रॉपर्टी | विवरण | | ------------ | ----------------------------------------------------------------------------------------------------------- | | `type` | हुई त्रुटि का प्रकार। संभावित वैल्यू के लिए नीचे दी गई टेबल देखें। | | `code` | त्रुटि का कोड। ये type से अधिक विशिष्ट होते हैं और इनसे त्रुटि का कारण पता किया जा सकता है। | | `message` | त्रुटि का संदेश। इसमें त्रुटि के बारे में ज़्यादा जानकारी होती है। | | `status` | त्रुटि की स्थिति। यह एक लेगसी फ़ील्ड है जिसका अब उपयोग नहीं होता; इसके बजाय `code` प्रॉपर्टी इस्तेमाल करें। | | `request_id` | त्रुटि का अनुरोध ID। यह अनुरोध का एक यूनिक आइडेंटिफ़ायर है, जिससे त्रुटि को ट्रबलशूट किया जा सकता है। | | `param` | वह पैरामीटर जिसने त्रुटि पैदा की। वैलिडेशन त्रुटि होने पर, यह अमान्य पैरामीटर बताएगा। | ### त्रुटि रिस्पॉन्स का उदाहरण गलत मॉडल ID वाले API अनुरोध का रिस्पॉन्स यहां दिया गया है: ```json { "detail": { "type": "validation_error", "code": "invalid_parameters", "message": "The 'keyterms' parameter is only supported with the 'scribe_v2' model. You specified 'scribe_v1'.", "status": "invalid_parameters", "request_id": "3c807fc4c3a1705f9638ecc764a91c01", "param": "keyterms" } } ``` त्रुटि प्रॉपर्टीज़ से हम देख सकते हैं कि यह एक वैलिडेशन त्रुटि है और कोड `invalid_parameters` है। संदेश में त्रुटि की ज़्यादा जानकारी होती है, और `request_id` अनुरोध का एक यूनिक आइडेंटिफ़ायर है जिससे त्रुटि को ट्रबलशूट किया जा सकता है। `param` प्रॉपर्टी उस पैरामीटर को बताती है जिसने त्रुटि पैदा की। ### SDK में त्रुटि हैंडलिंग ElevenLabs SDK टाइप्ड त्रुटि क्लासेज़ देते हैं, जिनसे आप त्रुटि की जानकारी एक्सेस कर सकते हैं। ```python from elevenlabs import ElevenLabs from elevenlabs.core import ApiError elevenlabs = ElevenLabs() try: audio = elevenlabs.text_to_speech.convert( voice_id="invalid-voice-id", model_id="eleven_v4", text="Hello, world!", ) except ApiError as e: print(f"Status code: {e.status_code}") # Access the error body if e.body and "detail" in e.body: detail = e.body["detail"] print(f"Error type: {detail.get('type')}") print(f"Error code: {detail.get('code')}") print(f"Message: {detail.get('message')}") print(f"Request ID: {detail.get('request_id')}") # Handle specific error types if detail.get("type") == "rate_limit_error": print("Rate limited - implement exponential backoff") elif detail.get("type") == "authentication_error": print("Check your API key") ``` ```typescript import { ElevenLabsClient, ElevenLabsError } from "@elevenlabs/elevenlabs-js"; const elevenlabs = new ElevenLabsClient(); try { const audio = await elevenlabs.textToSpeech.convert("invalid-voice-id", { text: "Hello, world!", modelId: "eleven_v4", }); } catch (error) { if (error instanceof ElevenLabsError) { console.log(`Status code: ${error.statusCode}`); // Access the error body const detail = (error.body as any)?.detail; if (detail) { console.log(`Error type: ${detail.type}`); console.log(`Error code: ${detail.code}`); console.log(`Message: ${detail.message}`); console.log(`Request ID: ${detail.request_id}`); // Handle specific error types if (detail.type === "rate_limit_error") { console.log("Rate limited - implement exponential backoff"); } else if (detail.type === "authentication_error") { console.log("Check your API key"); } } } } ``` अगर आप त्रुटि को ठीक नहीं कर पा रहे हैं, तो त्रुटि रिस्पॉन्स का `request_id`, पूरा त्रुटि संदेश और समस्या दोबारा पैदा करने के चरणों के साथ [support@elevenlabs.io](mailto:support@elevenlabs.io) पर सपोर्ट टीम को ईमेल करें। #### रेट लिमिटिंग और कॉन्करेंसी अगर आपको 429 HTTP स्टेटस कोड मिलता है, तो इसका मतलब है कि आपने कम समय में बहुत ज़्यादा अनुरोध किए हैं और API एंडपॉइंट की रेट लिमिट पार कर ली है, या API एंडपॉइंट की कॉन्करेंसी लिमिट पार कर ली है। त्रुटि `code` क्रमशः `rate_limit_exceeded` या `concurrent_limit_exceeded` होगा। रेट लिमिटिंग की स्थिति में, 429 त्रुटि मिलने पर आपको अपने कोड में एक्सपोनेंशियल बैकऑफ़ लागू करना चाहिए। यानी अनुरोध दोबारा भेजने से पहले कुछ देर इंतज़ार करना। कॉन्करेंसी की स्थिति में, नए अनुरोध करने से पहले मौजूदा अनुरोध पूरे होने का इंतज़ार करें। ज़्यादा जानकारी के लिए [कॉन्करेंसी और प्राथमिकता](/docs/hi/overview/models#concurrency-and-priority) सेक्शन देखें। ### त्रुटि के प्रकार हर त्रुटि में `type` प्रॉपर्टी होती है, जो हुई त्रुटि का प्रकार बताती है। संभावित वैल्यू के लिए नीचे दी गई टेबल देखें। | प्रकार | विवरण | HTTP स्टेटस कोड | | ---------------------- | --------------------------------------------------------------------------- | --------------- | | `validation_error` | अनुरोध में अमान्य पैरामीटर वैल्यू हैं। | 400 | | `invalid_request` | अनुरोध की संरचना गलत है या आवश्यक फ़ील्ड मौजूद नहीं हैं। | 400 | | `authentication_error` | ऑथेंटिकेशन विफल रहा - API key/token अमान्य है या मौजूद नहीं है। | 401 | | `payment_required` | यूज़र के पास पर्याप्त क्रेडिट नहीं हैं या भुगतान ज़रूरी है। | 402 | | `authorization_error` | ऑथेंटिकेट किए गए यूज़र के पास इस कार्रवाई के लिए ज़रूरी अनुमतियां नहीं हैं। | 403 | | `not_found` | मांगा गया रिसोर्स नहीं मिला। | 404 | | `conflict` | अनुरोध रिसोर्स की मौजूदा स्थिति से टकराता है। | 409 | | `rate_limit_error` | बहुत ज़्यादा अनुरोध - बाद में फिर कोशिश करें। | 429 | | `internal_error` | सर्वर में अनपेक्षित त्रुटि हुई। | 500 | | `service_unavailable` | सेवा अस्थायी रूप से उपलब्ध नहीं है; ऐसा बहुत कम ही होना चाहिए। | 503 | ### त्रुटि कोड
कोड प्रकार विवरण
`voice_not_found` `not_found` दिया गया वॉइस ID मौजूद नहीं है। वॉइस ID जांचें और फिर कोशिश करें।
`sample_not_found` `not_found` दिया गया वॉइस सैंपल नहीं मिला।
`voice_collection_not_found` `not_found` दिया गया वॉइस कलेक्शन मौजूद नहीं है।
`user_not_found` `not_found` दिया गया यूज़र नहीं मिला।
`auth_account_not_found` `not_found` ऑथेंटिकेशन अकाउंट नहीं मिला।
`workspace_not_found` `not_found` दिया गया वर्कस्पेस मौजूद नहीं है।
`project_not_found` `not_found` दिया गया प्रोजेक्ट नहीं मिला।
`history_item_not_found` `not_found` दिया गया हिस्ट्री आइटम मौजूद नहीं है।
`collection_not_found` `not_found` दिया गया कलेक्शन नहीं मिला।
`document_not_found` `not_found` दिया गया दस्तावेज़ मौजूद नहीं है।
`file_not_found` `not_found` दिया गया फ़ाइल नहीं मिली।
`conversation_not_found` `not_found` दिया गया कन्वर्सेशन मौजूद नहीं है।
`agent_not_found` `not_found` दिया गया एजेंट नहीं मिला।
`dubbing_not_found` `not_found` दिया गया डबिंग प्रोजेक्ट मौजूद नहीं है।
`song_not_found` `not_found` दिया गया गाना नहीं मिला।
`read_not_found` `not_found` दिया गया रीड नहीं मिला।
`pronunciation_dictionary_not_found` `not_found` दिया गया उच्चारण शब्दकोश मौजूद नहीं है।
`knowledge_base_not_found` `not_found` दिया गया नॉलेज बेस नहीं मिला।
`phone_number_not_found` `not_found` दिया गया फ़ोन नंबर मौजूद नहीं है।
`tool_not_found` `not_found` दिया गया टूल नहीं मिला।
`snapshot_not_found` `not_found` दिया गया स्नैपशॉट मौजूद नहीं है।
`task_not_found` `not_found` दिया गया टास्क नहीं मिला।
`model_not_found` `not_found` दिया गया मॉडल मौजूद नहीं है।
`transcript_not_found` `not_found` दिया गया ट्रांसक्रिप्ट नहीं मिला।
`keywords_list_not_found` `not_found` दी गई कीवर्ड्स सूची नहीं मिली।
`category_not_found` `not_found` दी गई कैटेगरी नहीं मिली।
`text_too_long` `validation_error` दिया गया टेक्स्ट अधिकतम अनुमत लंबाई से ज़्यादा है।
`text_too_short` `validation_error` दिया गया टेक्स्ट न्यूनतम ज़रूरी लंबाई से छोटा है।
`invalid_text` `validation_error` दिए गए टेक्स्ट में अमान्य कैरेक्टर या फ़ॉर्मैटिंग है।
`empty_text` `validation_error` टेक्स्ट फ़ील्ड खाली नहीं हो सकती।
`invalid_parameters` `validation_error` एक या अधिक अनुरोध पैरामीटर अमान्य हैं। अमान्य पैरामीटर के लिए `param` प्रॉपर्टी देखें।
`missing_required_field` `validation_error` अनुरोध में एक आवश्यक फ़ील्ड मौजूद नहीं है। गुम फ़ील्ड के लिए `param` प्रॉपर्टी देखें।
`invalid_voice_settings` `validation_error` वॉइस सेटिंग्स में अमान्य वैल्यू हैं। अमान्य वॉइस सेटिंग्स के लिए `param` प्रॉपर्टी देखें।
`invalid_voice_id` `validation_error` वॉइस ID का फ़ॉर्मैट अमान्य है।
`unsupported_model` `validation_error` यह मॉडल इस ऑपरेशन के लिए समर्थित नहीं है।
`invalid_audio` `validation_error` दिया गया ऑडियो अमान्य या करप्ट है।
`invalid_audio_format` `validation_error` दिया गया ऑडियो फ़ॉर्मैट समर्थित नहीं है।
`invalid_output_format` `validation_error` मांगा गया आउटपुट फ़ॉर्मैट समर्थित नहीं है।
`audio_too_long` `validation_error` ऑडियो अधिकतम अनुमत अवधि से ज़्यादा है।
`audio_too_short` `validation_error` ऑडियो न्यूनतम ज़रूरी अवधि से छोटा है।
`invalid_file_type` `validation_error` फ़ाइल टाइप समर्थित नहीं है।
`invalid_page_size` `validation_error` पेज साइज़ पैरामीटर अनुमत रेंज से बाहर है।
`invalid_cursor` `validation_error` पेजिनेशन कर्सर अमान्य है या उसकी समय-सीमा खत्म हो गई है।
`bad_request` `invalid_request` सर्वर अनुरोध को समझ नहीं सका।
`malformed_json` `invalid_request` अनुरोध बॉडी में अमान्य JSON है।
`invalid_content_type` `invalid_request` Content-Type हेडर मौजूद नहीं है या अमान्य है।
`request_too_large` `invalid_request` अनुरोध बॉडी अधिकतम अनुमत साइज़ से बड़ी है।
`invalid_api_key` `authentication_error` दी गई API key अमान्य है।
`missing_api_key` `authentication_error` अनुरोध में कोई API key नहीं दी गई थी।
`invalid_authorization_header` `authentication_error` Authorization हेडर का फ़ॉर्मैट अमान्य है।
`unauthorized` `authentication_error` इस रिसोर्स को एक्सेस करने के लिए ऑथेंटिकेशन ज़रूरी है।
`sign_in_required` `authentication_error` यह कार्रवाई करने के लिए आपको साइन इन करना होगा।
`forbidden` `authorization_error` इस रिसोर्स का एक्सेस निषिद्ध है।
`insufficient_permissions` `authorization_error` आपके पास इस कार्रवाई के लिए ज़रूरी अनुमतियां नहीं हैं।
`workspace_access_denied` `authorization_error` आपके पास इस वर्कस्पेस का एक्सेस नहीं है।
`feature_not_available` `authorization_error` यह फ़ीचर आपके मौजूदा प्लान में उपलब्ध नहीं है।
`subscription_required` `authorization_error` इस फ़ीचर को एक्सेस करने के लिए पेड सब्सक्रिप्शन ज़रूरी है।
`voice_access_denied` `authorization_error` आपके पास इस वॉइस का एक्सेस नहीं है।
`model_access_denied` `authorization_error` आपके पास इस मॉडल का एक्सेस नहीं है।
`conflict` `conflict` एक टकराव हुआ।
`resource_already_exists` `conflict` इसी आइडेंटिफ़ायर वाला एक रिसोर्स पहले से मौजूद है।
`voice_already_exists` `conflict` इस नाम की वॉइस पहले से मौजूद है।
`already_running` `conflict` ऑपरेशन पहले से चल रहा है।
`already_processing` `conflict` रिसोर्स पहले से प्रोसेस हो रहा है।
`concurrent_modification` `conflict` रिसोर्स को किसी दूसरे अनुरोध ने बदल दिया। नवीनतम वर्ज़न के साथ फिर कोशिश करें।
`slug_already_exists` `conflict` इस स्लग वाला एक रिसोर्स पहले से मौजूद है।
`rate_limit_exceeded` `rate_limit_error` बहुत ज़्यादा अनुरोध। दोबारा कोशिश करने से पहले इंतज़ार करें।
`concurrent_limit_exceeded` `rate_limit_error` कॉन्करेंट अनुरोधों की अधिकतम संख्या पार हो गई। उच्च सब्सक्रिप्शन टियर में कॉन्करेंसी लिमिट ज़्यादा होती है।
`system_busy` `rate_limit_error` सिस्टम इस समय व्यस्त है। बाद में फिर कोशिश करें।
`insufficient_credits` `payment_required` आपके अकाउंट में इस ऑपरेशन के लिए पर्याप्त क्रेडिट नहीं हैं।
`internal_error` `internal_error` एक अनपेक्षित त्रुटि हुई। अगर यह बनी रहे, तो सपोर्ट से संपर्क करें।
`service_unavailable` `service_unavailable` सेवा अस्थायी रूप से उपलब्ध नहीं है। बाद में फिर कोशिश करें।
`maintenance` `service_unavailable` सेवा का तय मेंटेनेंस चल रहा है।