Claude API का उपयोग करते समय डेवलपर्स को अक्सर 401 प्रमाणीकरण विफलता या 429 दर सीमा जैसी त्रुटियों का सामना करना पड़ता है, जो सेवा की स्थिरता को प्रभावित करता है। यह लेख सामान्य त्रुटि कोड के कारणों और व्यावहारिक सुधार चरणों को सूचीबद्ध करता है ताकि आप जल्दी से सामान्य कॉल बहाल कर सकें।
401 अनधिकृत त्रुटि: API कुंजी और अनुमतियाँ जाँचें
401 का रिटर्न आमतौर पर API कुंजी के अमान्य, समाप्त, या गलत तरीके से पास होने का संकेत देता है। पहले अनुरोध हेडर में सुनिश्चित करें कि Authorization फ़ील्ड का प्रारूप Bearer YOUR_API_KEY है, और केस सेंसिटिविटी तथा ट्रेलिंग स्पेस पर ध्यान दें। यदि कुंजी एनवायरनमेंट वेरिएबल के माध्यम से लोड की गई है, तो वेरिएबल नाम की स्पेलिंग error की जाँच करें।
कुछ परिदृश्यों में, कुंजी संगठन-स्तरीय नीतियों द्वारा प्रतिबंधित हो सकती है और विशिष्ट मॉडल (जैसे claude-3-opus) को कॉल करने में असमर्थ होती है। Anthropic कंसोल में लॉग इन करके API कुंजी के अनुमति दायरे की जाँच करें, और आवश्यक होने पर नई कुंजी उत्पन्न करें तथा इसे एक नए प्रोजेक्ट से बाँधें।
429 दर सीमा त्रुटि: अनुरोध आवृत्ति को उचित रूप से नियंत्रित करें
429 इंगित करता है कि वर्तमान अनुरोधों की संख्या प्रति मिनट कोटा से अधिक हो गई है। Claude API अनुरोधों की संख्या और टोकन दोनों पर सीमाएँ लगाता है। आप प्रतिक्रिया हेडर X-RateLimit-Remaining के माध्यम से शेष कोटा का पूर्वानुमान लगा सकते हैं। कोड में एक्सपोनेंशियल बैकऑफ़ रीट्राई लागू करने की सलाह दी जाती है: पहला प्रयास 1 सेकंड तक प्रतीक्षा करें, विफलता पर अधिकतम 30 सेकंड तक दोगुना करें।
