Developer guide
त्रुटी कोड
स्थिती कोडनुसार उपाय आणि पुन्हा प्रयत्न करण्याचे नियम
या पृष्ठावर गेटवेकडून परत केले जाणारे स्थिती कोड आणि त्यांचे अर्थ, तसेच प्रत्येक कोडनुसार करावयाच्या उपायांची माहिती दिली आहे.
अपस्ट्रीमकडून 4xx·5xx मिळाल्यास तो कोड जसाच्या तसा पुढे पाठवला जातो; इतर बाबतीत खालील तक्ता लागू होतो.
दोन सुसंगत विनिर्देशांच्या त्रुटीच्या मजकुराचा आकार आणि Anthropic-सुसंगत error.type चे नियम, तसेच मर्यादा आणि वापर तपासण्यासाठीच्या कन्सोल स्क्रीनची माहितीही दिली आहे.
स्थिती कोड
| कोड | अर्थ | उपाय |
|---|---|---|
| 400 | विनंती मूल्य त्रुटी. Anthropic-सुसंगत मॉडेल सूचीतील limit 1~1000 च्या बाहेर आहे किंवा GET /responses/{responseId}?stream=true वापरून जतन केलेला प्रतिसाद पुढे घेण्याचा प्रयत्न केला आहे | मूल्य मर्यादेच्या आत दुरुस्त करा. जतन केलेला प्रतिसाद stream शिवाय मिळवा. |
| 401 | की उपलब्ध नाही किंवा कालबाह्य·रद्द केलेली की | API कीच्या पृष्ठावर कीची स्थिती तपासा आणि हेडरचे नाव व Bearer उपसर्ग तपासा. |
| 403 | मॉडेलवर प्रवेशाची परवानगी नाही, वापराची मर्यादा ओलांडली आहे, क्रेडिट अपुरे आहे किंवा व्हॉइसचा मालक नाही | error.message कारण वेगळे करून दाखवते. संख्यात्मक माहिती खालील मर्यादा आणि वापर तपासणी विभागातील स्क्रीनवर पाहा. |
| 404 | मॉडेल अस्तित्वात नाही किंवा या कीद्वारे त्यावर प्रवेश करता येत नाही (समर्थन समाप्त झालेल्या मॉडेलसह), मार्ग अस्तित्वात नाही किंवा 3 दिवसांचा जतन कालावधी संपलेला CleviDrive आउटपुट | GET /models वापरून कॉल करता येणाऱ्या मॉडेलची सूची आधी तपासा. मार्ग API कॉल करा पृष्ठावरील तक्त्याशी पडताळा. |
| 408 · 409 · 413 | अपस्ट्रीम वेळेची मर्यादा ओलांडली, गर्दी किंवा विनंतीचा आकार मर्यादेपेक्षा जास्त. आवाज·व्हॉइस मार्गासाठी वेळेची मर्यादा 5 मिनिटे आणि विनंतीची कमाल मर्यादा 28 MiB आहे | 409 मध्ये Retry-After असल्यास तेवढा वेळ थांबा. 413 असल्यास विनंती भागांमध्ये पाठवा. |
| 429 | अपस्ट्रीम प्रदात्याने वेगावर मर्यादा घातली असल्यास | Retry-After मिळाल्यास त्याचे तंतोतंत पालन करा; नसल्यास एक्स्पोनेन्शियल बॅकऑफ वापरून पुन्हा प्रयत्न करा. |
| 5xx | गेटवे किंवा अपस्ट्रीमची तात्पुरती त्रुटी (503 समाविष्ट) | एक्स्पोनेन्शियल बॅकऑफ वापरून पुन्हा प्रयत्न करा. समस्या वारंवार येत असल्यास X-Request-Id सह मदत व संपर्क विभागाद्वारे आम्हाला कळवा. |
पुन्हा प्रयत्न
गेटवे स्वतःचा 429 तयार करत नाही आणि अपस्ट्रीम प्रतिसादावर गुप्तपणे पुन्हा प्रयत्न करत नाही किंवा तो रांगेतही ठेवत नाही.
प्रतीक्षा आणि पुन्हा प्रयत्न क्लायंट करतो.
| कोड | प्रतीक्षा वेळ | त्यानंतर |
|---|---|---|
| 409 | Retry-After असल्यास तो कालावधी | तीच विनंती पुन्हा पाठवा. |
| 429 | Retry-After असल्यास तो कालावधी, नसल्यास घातांकीय बॅकऑफ | तीच विनंती पुन्हा पाठवा. |
| 5xx | घातांकीय बॅकऑफ | पुन्हा होत असल्यास संपर्क साधा. |
| 413 | प्रतीक्षा नाही | विनंतीचे भाग करा. |
त्रुटीचा मुख्य भाग
त्रुटीच्या मुख्य भागाचा आकार विनिर्देशानुसार वेगळा असतो. अपस्ट्रीम त्रुटीमध्ये केवळ संदेश ठेवून तो व्यवस्थित पाठवला जातो; स्टॅक किंवा अंतर्गत फील्ड पाठवले जात नाहीत.
हा OpenAI-सुसंगत मार्गाचा मुख्य भाग आहे.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}हा Anthropic-सुसंगत मार्गाचा मुख्य भाग आहे. error.type हा स्थिती कोडनुसार ठरवला जातो.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| स्थिती कोड | error.type |
|---|---|
| 400 | invalid_request_error |
| 401 | authentication_error |
| 403 | permission_error |
| 404 | not_found_error |
| 413 | request_too_large |
| 429 | rate_limit_error |
| 529 | overloaded_error |
| इतर कोड | api_error |
मर्यादा आणि वापर तपासा
मर्यादेची मूल्ये प्रत्येक वर्कस्पेसनुसार वेगळी असतात. 403 चे कारण error.message मध्ये तपासल्यानंतर खालील स्क्रीनवर मूल्ये पहा.
| तपासायची गोष्ट | कन्सोल स्क्रीन |
|---|---|
| माझ्या वर्कस्पेसवर लागू असलेली मर्यादा | आढाव्यातील वाटप केलेली वापर मर्यादा |
| प्लॅनने अनुमती दिलेली श्रेणी आणि शिल्लक | प्लॅन आणि क्रेडिट्स |
| प्रत्यक्ष वापर (मॉडेलनुसार·कीनुसार कॉलची संख्या, अंदाजे वजा होणारे क्रेडिट्स) | वापर |
| कीची स्थिती (कालबाह्य·रद्द केली आहे का) | API की |