मुख्य सामग्री पर जाएं
संदेश के टेक्स्ट के आधार पर नहीं, बल्कि error.code और HTTP स्थिति के आधार पर ब्रांच करें। हर एंडपॉइंट पर Phaseo की हर त्रुटि की JSON बॉडी एक जैसी होती है, और उसका error ऑब्जेक्ट (code, message, type, param) वही रूप है जिसे OpenAI-संगत SDK पढ़ते हैं, इसलिए उनके exceptions में Phaseo का संदेश आता है।

हर त्रुटि के फ़ील्ड

कुछ त्रुटियां और संदर्भ जोड़ती हैं:

त्रुटि प्रकार

error.type OpenAI के दस्तावेज़ित त्रुटि प्रकारों का पालन करता है और HTTP स्थिति से तय होता है: /v1/messages पर त्रुटियां वही बॉडी इस्तेमाल करती हैं, इसलिए Anthropic SDK को भी error.type और error.message मिलते हैं।

त्रुटि कोड

सही त्रुटियों पर दोबारा कोशिश करें

प्रयासों की एक सीमा और एक कुल समय-सीमा तय करें। रेट लिमिट हेडर के लिए अनुरोध सीमाएँ देखें।

जब कोई प्रदाता विफल हो

जब Phaseo किसी प्रदाता तक पहुंचा और अनुरोध फिर भी विफल हुआ, तो provider_failure_diagnostics में एक category, एक hint और provider होता है। श्रेणियां:

जब कोई मॉडल या एंडपॉइंट उपलब्ध न हो

unsupported_model_or_endpoint त्रुटियों में provider_candidate_diagnostics, provider_enablement, missing_pricing_providers और routing_diagnostics हो सकते हैं। ये मिलकर बताते हैं कि मॉडल अभी सक्रिय नहीं है, मॉडल एंडपॉइंट का समर्थन नहीं करता, कीमत मौजूद नहीं है, या रोलआउट प्रतिबंध है।

जब कोई मॉडल सेवानिवृत्त हो

सेवानिवृत्त मॉडल तब तक दिया जाता है जब तक कोई प्रदाता उसे देता है। जब कोई नहीं देता, तो अनुरोध 410 और model_retired के साथ विफल होते हैं:
model वह मॉडल है जो आपने मांगा, retired_at वह समय है जब इसे सेवानिवृत्त किया गया (या null), और replacement_model सुझाया गया विकल्प है (या null)। दोबारा कोशिश करने से मदद नहीं मिलती; मॉडल ID बदलें। माइग्रेशन के दौरान इन अनुरोधों को चालू रखने के लिए, विकल्प को अनुरोध की models सूची में जोड़ें या वर्कस्पेस के लिए सेवानिवृत्त मॉडल रूटिंग चालू करें। मॉडल का पदावनयन और सेवानिवृत्ति देखें।

स्ट्रीम के दौरान त्रुटियां

अगर कोई अनुरोध स्ट्रीमिंग शुरू होने से पहले विफल होता है, तो आपको ऊपर वाली JSON त्रुटि बॉडी मिलती है। अगर वह स्ट्रीम के बीच में विफल होता है, तो स्ट्रीम सामान्य समाप्ति के बजाय एंडपॉइंट के विफलता इवेंट के साथ खत्म होती है: आंशिक आउटपुट को अधूरा मानें और दोबारा कोशिश का विकल्प दें। Chat Completions के error फ़्रेम में वही त्रुटि ऑब्जेक्ट होता है, जिसमें error.type कोड से तय होता है:
बिना स्ट्रीमिंग वाला अनुरोध, जिसका प्रदाता बीच में विफल हो जाता है, आंशिक प्रतिक्रिया नहीं, बल्कि upstream_stream_failure के साथ 502 लौटाता है। स्ट्रीमिंग देखें।

किसी अनुरोध को डीबग करें

रूटिंग ट्रेस और अपस्ट्रीम पेलोड पाने के लिए एक debug ऑब्जेक्ट भेजें:
trace_level summary या full होता है। डीबग पेलोड में आपके अनुरोध की सामग्री हो सकती है, इसलिए इन्हें सिर्फ़ डेवलपमेंट या कड़े नियंत्रण वाले वातावरण में इस्तेमाल करें। debug देखें। जब कोई अनुरोध विफल हो, तो घटनाओं के लिए स्टेटस पेज देखें, अपने पेलोड की तुलना एंडपॉइंट के संदर्भ पेज से करें, और एंडपॉइंट और मॉडल के साथ generation_id लॉग करें। सपोर्ट से संपर्क करते समय generation_id शामिल करें।
अंतिम संशोधन 5 नवंबर 2026