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 कुंजी |