रेफरेंस

त्रुटियां

त्रुटि संदेश और समाधान देखें।

API त्रुटियां

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

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

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

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

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

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

{
  "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_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")

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

अगर आपको 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_foundnot_foundदिया गया वॉइस ID मौजूद नहीं है। वॉइस ID जांचें और फिर कोशिश करें।
sample_not_foundnot_foundदिया गया वॉइस सैंपल नहीं मिला।
voice_collection_not_foundnot_foundदिया गया वॉइस कलेक्शन मौजूद नहीं है।
user_not_foundnot_foundदिया गया यूज़र नहीं मिला।
auth_account_not_foundnot_foundऑथेंटिकेशन अकाउंट नहीं मिला।
workspace_not_foundnot_foundदिया गया वर्कस्पेस मौजूद नहीं है।
project_not_foundnot_foundदिया गया प्रोजेक्ट नहीं मिला।
history_item_not_foundnot_foundदिया गया हिस्ट्री आइटम मौजूद नहीं है।
collection_not_foundnot_foundदिया गया कलेक्शन नहीं मिला।
document_not_foundnot_foundदिया गया दस्तावेज़ मौजूद नहीं है।
file_not_foundnot_foundदिया गया फ़ाइल नहीं मिली।
conversation_not_foundnot_foundदिया गया कन्वर्सेशन मौजूद नहीं है।
agent_not_foundnot_foundदिया गया एजेंट नहीं मिला।
dubbing_not_foundnot_foundदिया गया डबिंग प्रोजेक्ट मौजूद नहीं है।
song_not_foundnot_foundदिया गया गाना नहीं मिला।
read_not_foundnot_foundदिया गया रीड नहीं मिला।
pronunciation_dictionary_not_foundnot_foundदिया गया उच्चारण शब्दकोश मौजूद नहीं है।
knowledge_base_not_foundnot_foundदिया गया नॉलेज बेस नहीं मिला।
phone_number_not_foundnot_foundदिया गया फ़ोन नंबर मौजूद नहीं है।
tool_not_foundnot_foundदिया गया टूल नहीं मिला।
snapshot_not_foundnot_foundदिया गया स्नैपशॉट मौजूद नहीं है।
task_not_foundnot_foundदिया गया टास्क नहीं मिला।
model_not_foundnot_foundदिया गया मॉडल मौजूद नहीं है।
transcript_not_foundnot_foundदिया गया ट्रांसक्रिप्ट नहीं मिला।
keywords_list_not_foundnot_foundदी गई कीवर्ड्स सूची नहीं मिली।
category_not_foundnot_foundदी गई कैटेगरी नहीं मिली।
text_too_longvalidation_errorदिया गया टेक्स्ट अधिकतम अनुमत लंबाई से ज़्यादा है।
text_too_shortvalidation_errorदिया गया टेक्स्ट न्यूनतम ज़रूरी लंबाई से छोटा है।
invalid_textvalidation_errorदिए गए टेक्स्ट में अमान्य कैरेक्टर या फ़ॉर्मैटिंग है।
empty_textvalidation_errorटेक्स्ट फ़ील्ड खाली नहीं हो सकती।
invalid_parametersvalidation_error

एक या अधिक अनुरोध पैरामीटर अमान्य हैं। अमान्य पैरामीटर के लिए param प्रॉपर्टी देखें।

missing_required_fieldvalidation_error

अनुरोध में एक आवश्यक फ़ील्ड मौजूद नहीं है। गुम फ़ील्ड के लिए param प्रॉपर्टी देखें।

invalid_voice_settingsvalidation_error

वॉइस सेटिंग्स में अमान्य वैल्यू हैं। अमान्य वॉइस सेटिंग्स के लिए param प्रॉपर्टी देखें।

invalid_voice_idvalidation_errorवॉइस ID का फ़ॉर्मैट अमान्य है।
unsupported_modelvalidation_errorयह मॉडल इस ऑपरेशन के लिए समर्थित नहीं है।
invalid_audiovalidation_errorदिया गया ऑडियो अमान्य या करप्ट है।
invalid_audio_formatvalidation_errorदिया गया ऑडियो फ़ॉर्मैट समर्थित नहीं है।
invalid_output_formatvalidation_errorमांगा गया आउटपुट फ़ॉर्मैट समर्थित नहीं है।
audio_too_longvalidation_errorऑडियो अधिकतम अनुमत अवधि से ज़्यादा है।
audio_too_shortvalidation_errorऑडियो न्यूनतम ज़रूरी अवधि से छोटा है।
invalid_file_typevalidation_errorफ़ाइल टाइप समर्थित नहीं है।
invalid_page_sizevalidation_errorपेज साइज़ पैरामीटर अनुमत रेंज से बाहर है।
invalid_cursorvalidation_errorपेजिनेशन कर्सर अमान्य है या उसकी समय-सीमा खत्म हो गई है।
bad_requestinvalid_requestसर्वर अनुरोध को समझ नहीं सका।
malformed_jsoninvalid_requestअनुरोध बॉडी में अमान्य JSON है।
invalid_content_typeinvalid_requestContent-Type हेडर मौजूद नहीं है या अमान्य है।
request_too_largeinvalid_requestअनुरोध बॉडी अधिकतम अनुमत साइज़ से बड़ी है।
invalid_api_keyauthentication_errorदी गई API key अमान्य है।
missing_api_keyauthentication_errorअनुरोध में कोई API key नहीं दी गई थी।
invalid_authorization_headerauthentication_errorAuthorization हेडर का फ़ॉर्मैट अमान्य है।
unauthorizedauthentication_errorइस रिसोर्स को एक्सेस करने के लिए ऑथेंटिकेशन ज़रूरी है।
sign_in_requiredauthentication_errorयह कार्रवाई करने के लिए आपको साइन इन करना होगा।
forbiddenauthorization_errorइस रिसोर्स का एक्सेस निषिद्ध है।
insufficient_permissionsauthorization_errorआपके पास इस कार्रवाई के लिए ज़रूरी अनुमतियां नहीं हैं।
workspace_access_deniedauthorization_errorआपके पास इस वर्कस्पेस का एक्सेस नहीं है।
feature_not_availableauthorization_errorयह फ़ीचर आपके मौजूदा प्लान में उपलब्ध नहीं है।
subscription_requiredauthorization_errorइस फ़ीचर को एक्सेस करने के लिए पेड सब्सक्रिप्शन ज़रूरी है।
voice_access_deniedauthorization_errorआपके पास इस वॉइस का एक्सेस नहीं है।
model_access_deniedauthorization_errorआपके पास इस मॉडल का एक्सेस नहीं है।
conflictconflictएक टकराव हुआ।
resource_already_existsconflictइसी आइडेंटिफ़ायर वाला एक रिसोर्स पहले से मौजूद है।
voice_already_existsconflictइस नाम की वॉइस पहले से मौजूद है।
already_runningconflictऑपरेशन पहले से चल रहा है।
already_processingconflictरिसोर्स पहले से प्रोसेस हो रहा है।
concurrent_modificationconflictरिसोर्स को किसी दूसरे अनुरोध ने बदल दिया। नवीनतम वर्ज़न के साथ फिर कोशिश करें।
slug_already_existsconflictइस स्लग वाला एक रिसोर्स पहले से मौजूद है।
rate_limit_exceededrate_limit_errorबहुत ज़्यादा अनुरोध। दोबारा कोशिश करने से पहले इंतज़ार करें।
concurrent_limit_exceededrate_limit_error

कॉन्करेंट अनुरोधों की अधिकतम संख्या पार हो गई। उच्च सब्सक्रिप्शन टियर में कॉन्करेंसी लिमिट ज़्यादा होती है।

system_busyrate_limit_errorसिस्टम इस समय व्यस्त है। बाद में फिर कोशिश करें।
insufficient_creditspayment_requiredआपके अकाउंट में इस ऑपरेशन के लिए पर्याप्त क्रेडिट नहीं हैं।
internal_errorinternal_errorएक अनपेक्षित त्रुटि हुई। अगर यह बनी रहे, तो सपोर्ट से संपर्क करें।
service_unavailableservice_unavailableसेवा अस्थायी रूप से उपलब्ध नहीं है। बाद में फिर कोशिश करें।
maintenanceservice_unavailableसेवा का तय मेंटेनेंस चल रहा है।