त्रुटियां | ElevenLabs Documentation

API त्रुटियां

ElevenLabs किसी अनुरोध की सफलता या विफलता बताने के लिए मानक HTTP स्टेटस कोड का उपयोग करता है। इसके अलावा, सभी API अनुरोध detail प्रॉपर्टी वाला एक JSON ऑब्जेक्ट लौटाते हैं, जिसमें त्रुटि की जानकारी होती है।

आम तौर पर, 200 HTTP स्टेटस कोड सफल अनुरोध बताता है। 4xx कोड अनुरोध में किसी समस्या का संकेत देता है, जैसे अमान्य पैरामीटर या आवश्यक फ़ील्ड का न होना। 500 HTTP स्टेटस कोड ElevenLabs के सर्वर में समस्या बताता है, जो बहुत कम ही होना चाहिए।

त्रुटि प्रॉपर्टीज़

प्रॉपर्टी	विवरण
`type`	हुई त्रुटि का प्रकार। संभावित वैल्यू के लिए नीचे दी गई टेबल देखें।
`code`	त्रुटि का कोड। यह प्रकार से ज़्यादा विशिष्ट होता है और इससे त्रुटि का कारण पता किया जा सकता है।
`message`	त्रुटि का संदेश। इसमें त्रुटि के बारे में और जानकारी मिलती है।
`status`	त्रुटि की स्थिति। यह एक पुरानी फ़ील्ड है जिसका अब उपयोग नहीं होता; इसके बजाय `code` प्रॉपर्टी का उपयोग करें।
`request_id`	त्रुटि का अनुरोध ID। यह अनुरोध का एक विशिष्ट पहचानकर्ता है, जिससे त्रुटि का समाधान किया जा सकता है।
`param`	त्रुटि पैदा करने वाला पैरामीटर। वैलिडेशन त्रुटि के मामले में, यह अमान्य पैरामीटर बताएगा।

उदाहरण त्रुटि रिस्पॉन्स

यह उस API अनुरोध का रिस्पॉन्स है जिसमें गलत मॉडल ID का उपयोग किया गया था:

{
  "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 टाइप की गई त्रुटि क्लासेस देता है, जिनसे आप त्रुटि की जानकारी ऐक्सेस कर सकते हैं।

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_v3",
        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")

रेट लिमिटिंग और कॉन्करेंसी

अगर आपको 429 HTTP स्टेटस कोड मिलता है, तो इसका मतलब है कि आपने कम समय में बहुत ज़्यादा अनुरोध किए हैं और API एंडपॉइंट की रेट लिमिट पार कर ली है, या API एंडपॉइंट की कॉन्करेंसी लिमिट पार कर ली है। त्रुटि code क्रमशः rate_limit_exceeded या concurrent_limit_exceeded होगा।

रेट लिमिटिंग के मामले में, 429 त्रुटि मिलने पर आपको अपने कोड में एक्सपोनेंशियल बैकऑफ़ लागू करना चाहिए। यानी अनुरोध को फिर से भेजने से पहले कुछ देर रुकना।

कॉन्करेंसी के मामले में, नए अनुरोध भेजने से पहले मौजूदा अनुरोध पूरे होने की प्रतीक्षा करें। अधिक जानकारी के लिए कॉन्करेंसी और प्राथमिकता सेक्शन देखें।

त्रुटि प्रकार

त्रुटि में 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`	सेवा का निर्धारित रखरखाव चल रहा है।