4 में से पाठ 3 · 8 मिनट

जब अनुरोध विफल हो

त्रुटि कोड और स्टेटस के आधार पर आगे बढ़ें, और सिर्फ़ उन त्रुटियों पर दोबारा कोशिश करें जो बाद में सफल हो सकती हैं।

हर Phaseo त्रुटि की JSON बॉडी हर एंडपॉइंट पर एक जैसी होती है। error ऑब्जेक्ट उसी फ़ॉर्मैट में है जिसे OpenAI-संगत SDK पहले से पढ़ते हैं:

{
  "error": {
    "code": "insufficient_funds",
    "message": "...",
    "type": "insufficient_quota",
    "param": null
  },
  "generation_id": "G-...",
  "status_code": 402
}

error.code और HTTP स्टेटस के आधार पर फ़ैसला करें, संदेश के टेक्स्ट के आधार पर कभी नहीं। generation_id हमेशा लॉग करें।

स्टेटसआम कोडक्या करें
400validation_error, model_requiredअनुरोध ठीक करें। error.param फ़ील्ड का नाम बताता है।
401unauthorisedकुंजी और Authorization हेडर जाँचें।
402insufficient_fundsक्रेडिट जोड़ें, या phaseo/free इस्तेमाल करें।
403guardrail_blockedअनुरोध या गार्डरेल बदलें।
404not_foundपाथ और ID जाँचें।
410model_retiredreplacement_model पर जाएँ।
429rate_limit_exceeded, key_limit_exceededRetry-After तक रुकें, फिर दोबारा कोशिश करें।
5xxupstream_error, gateway_errorbackoff के साथ दोबारा कोशिश करें।

429 के अलावा 4xx त्रुटियों पर बिना बदलाव दोबारा कोशिश न करें: वे फिर विफल होंगी। 429 के लिए Retry-After (सेकंड या HTTP तारीख) तक रुकें, या jitter के साथ exponential backoff इस्तेमाल करें। Retry-After के बिना आया key_limit_exceeded अपने आप रीसेट नहीं होगा, इसलिए उस पर दोबारा कोशिश न करें। 5xx पर सिर्फ़ तब दोबारा कोशिश करें जब कॉल दोहराना सुरक्षित हो, और कोशिशों की सीमा और कुल समय-सीमा तय करें।

अपनी समझ जाँचें

आपका अनुरोध unauthorised कोड के साथ 401 लौटाता है। आपके कोड को क्या करना चाहिए?

इसे लागू करें

एक बैच स्क्रिप्ट लूप में 500 अनुरोध भेजती है। आधे रास्ते में जवाब Retry-After: 20 हेडर के साथ 429 के रूप में आने लगते हैं। आप क्या बदलेंगे?

जवाब दिखाएँ

स्क्रिप्ट से Retry-After का पालन करवाएँ: दोबारा कोशिश से पहले लगभग 20 सेकंड रुकें, और हेडर न हो तो jitter वाले exponential backoff पर जाएँ। error.code भी जाँचें: rate_limit_exceeded रीसेट हो जाएगा, लेकिन Retry-After के बिना key_limit_exceeded नहीं होगा, इसलिए उस पर दोबारा कोशिश बेकार है।

मुख्य बात

error.code और स्टेटस के आधार पर फ़ैसला करें, 4xx त्रुटियाँ ठीक करें, और सिर्फ़ 429 और सुरक्षित 5xx त्रुटियों पर backoff के साथ दोबारा कोशिश करें।

संबंधित लिंक

प्रगति इसी ब्राउज़र में सेव होती है।

आखिरी बार जाँचा गया 17 नवंबर 2026