OpenAI API त्रुटियों की पहचान: एक दोहराने योग्य और सीमित परीक्षण योजना
OpenAI API में प्रमाणीकरण, दर-सीमा, टाइमआउट और गलत प्रारूप वाली प्रतिक्रिया की समस्याओं को अलग-अलग पहचानें—और असीमित रीट्राई या खर्च के बिना उनका दोबारा परीक्षण करें।
सारांश · TL;DR
हर मामले के लिए स्थिति, त्रुटि कोड, लगा समय और प्रतिक्रिया का स्वरूप दर्ज करना, OpenAI API की जाँच को दोहराने योग्य बनाता है। केवल अस्थायी विफलताओं पर सीमित रीट्राई करें; प्रमाणीकरण, कोटा और अनुरोध संबंधी त्रुटियों को रीट्राई करने के बजाय ठीक करें।
मुख्य बातें
- विफलताओं की पहचान केवल HTTP स्थिति से नहीं, बल्कि उसके साथ मिले विशिष्ट त्रुटि कोड से करें।
- दर-सीमा और सर्वर की अस्थायी त्रुटियों पर तय प्रयास और समय-सीमा के भीतर रीट्राई करें; प्रमाणीकरण या क्रेडिट समाप्त होने की त्रुटियों को अस्थायी मानकर रीट्राई न करें।
- सफल HTTP स्थिति और मान्य JSON के अलावा, प्रतिक्रिया की संरचना की भी अलग से जाँच करें।
- परीक्षण मामलों का छोटा, दोहराने योग्य समूह रखें और हर विफलता को फिर से उत्पन्न करने के लिए आवश्यक परिस्थितियाँ दर्ज करें।
इस पृष्ठ पर (6)
सीमित दायरे में समस्या की पहचान से शुरुआत करें
OpenAI API कॉल विफल होने पर पहले तय करें कि समस्या पहुँच, अनुरोधों की संख्या, लगा समय या लौटाए गए डेटा से जुड़ी है। इसी आधार पर आप तय कर सकते हैं कि क्रेडेंशियल बदलने हैं, ट्रैफ़िक धीमा करना है, रीट्राई करना है या अपने एप्लिकेशन की पार्सिंग की जाँच करनी है। केवल 429 देखकर समाधान तय नहीं किया जा सकता: यह अस्थायी दर-सीमा हो सकती है या खर्च अथवा क्रेडिट की सीमा, जिसे एक और रीट्राई से ठीक नहीं किया जा सकता।
OpenAI की त्रुटि-कोड मार्गदर्शिका में API त्रुटि कोड और उनसे जुड़े Python लाइब्रेरी अपवाद दिए गए हैं। आपको जो प्रतिक्रिया मिलती है, उसकी व्याख्या के लिए इसे संदर्भ के रूप में उपयोग करें: OpenAI API त्रुटि कोड।
विफलता की चार आम श्रेणियों की जाँच करें
| लक्षण | सबसे पहले जाँचें | अगला कदम |
|---|---|---|
401 प्रमाणीकरण त्रुटि | क्या कुंजी मान्य और सक्रिय है? क्या सही संगठन का उपयोग हो रहा है? | कुंजी या संगठन ठीक करें। लागू होने पर प्रोजेक्ट की अनुमतियाँ और IP allowlist जाँचें। |
429 प्रतिक्रिया | विशिष्ट त्रुटि कोड और Retry-After हेडर देखें। | दर-सीमा होने पर अनुरोधों की गति नियंत्रित करें। क्रेडिट समाप्त होने या खर्च अथवा उपयोग की सीमा के लिए, रीट्राई से पहले उस सीमा का समाधान करें। |
| टाइमआउट या कनेक्शन त्रुटि | अनुरोध टाइमआउट और कनेक्ट न हो पाने के बीच अंतर करें। लगा समय और नेटवर्क की परिस्थितियाँ दर्ज करें। | उपयुक्त हो तो थोड़ी देर बाद सावधानी से रीट्राई करें; कनेक्शन त्रुटियों के लिए प्रॉक्सी, सर्टिफ़िकेट या फ़ायरवॉल नियमों की जाँच करें। |
| सफल HTTP प्रतिक्रिया, लेकिन अनुपयोगी परिणाम | जाँचें कि बॉडी पार्स हो रही है या नहीं और आपके एप्लिकेशन के लिए ज़रूरी फ़ील्ड मौजूद हैं तथा अपेक्षित प्रकार के हैं या नहीं। | किसी अनुपस्थित या अमान्य फ़ील्ड को एप्लिकेशन-स्तर की प्रतिक्रिया-सत्यापन विफलता मानें, न कि अपने-आप API प्रमाणीकरण या दर-सीमा की त्रुटि। |
OpenAI की मार्गदर्शिका अमान्य क्रेडेंशियल को 401 बताती है और 429 के कई अलग-अलग कारण गिनाती है, जिनमें अनुरोध दर, क्रेडिट समाप्त होना और संगठन या प्रोजेक्ट की सीमाएँ शामिल हैं। दर-सीमा के लिए, यदि Retry-After मौजूद हो तो मार्गदर्शिका उसका पालन करने की सलाह देती है। बिलिंग, खर्च और कोटा संबंधी त्रुटियों के लिए संबंधित सीमा का समाधान करना ज़रूरी है; बार-बार रीट्राई करने से पहुँच बहाल नहीं होती। मार्गदर्शिका APITimeoutError और APIConnectionError को Python लाइब्रेरी के अलग-अलग अपवादों के रूप में भी सूचीबद्ध करती है। स्रोत: OpenAI त्रुटि कोड।
छोटे मूल्यांकन को दोहराने योग्य बनाएँ
मनमाने prompts बार-बार भेजने के बजाय परीक्षण मामलों का एक तय समूह इस्तेमाल करें। शुरुआत ऐसे मामलों से करें जिनमें एक समय में केवल एक स्थिति की जाँच हो:
- आधारभूत जाँच: छोटा, पहले से मान्य इनपुट भेजें और पुष्टि करें कि अपेक्षित प्रतिक्रिया फ़ील्ड मौजूद है।
- प्रमाणीकरण जाँच: सही प्रोजेक्ट क्रेडेंशियल के साथ वही आधारभूत जाँच चलाएँ। असली कुंजी को जानबूझकर लॉग या परीक्षण रिपोर्ट में उजागर न करें।
- अनुरोध सत्यापन: यदि आपके परीक्षण परिवेश में अनुमति हो, तो नियंत्रित परीक्षण में कोई आवश्यक पैरामीटर छोड़ दें या उसकी वर्तनी गलत रखें। मिली स्थिति और संदेश दर्ज करें; यह न मानें कि सभी गलत अनुरोध एक ही तरह विफल होंगे।
- दर-सीमा प्रबंधन:
Retry-Afterहेडर सहित, नकली429प्रतिक्रिया से अपनी रीट्राई लॉजिक जाँचें। सीमा उत्पन्न करने के लिए असली ट्रैफ़िक न भेजें। - टाइमआउट प्रबंधन: अपने क्लाइंट या परीक्षण व्यवस्था में टाइमआउट का अनुकरण करें। धीमे परीक्षण एंडपॉइंट या प्रोडक्शन पर बार-बार कॉल करने से अनावश्यक लोड और अस्पष्ट नतीजे हो सकते हैं।
- प्रतिक्रिया सत्यापन: मान्य JSON बॉडी के ऐसे मामले जाँचें जिनमें आवश्यक फ़ील्ड न हो, फ़ील्ड का प्रकार गलत हो और JSON अमान्य हो। ये पार्सर या कॉन्ट्रैक्ट से जुड़ी अलग-अलग विफलताएँ हैं।
हर मामले के लिए टाइमस्टैम्प और टाइमज़ोन, एंडपॉइंट या ऑपरेशन, मॉडल, उपलब्ध होने पर HTTP स्थिति, त्रुटि का प्रकार और कोड, प्रयासों की संख्या, लगा समय और अनुरोध पहचानकर्ता या निदान-संदर्भ का ऐसा रूप दर्ज करें जिसमें संवेदनशील जानकारी छिपाई गई हो। साझा लॉग में क्रेडेंशियल या संवेदनशील इनपुट कभी न रखें। लगातार बनी समस्या के लिए OpenAI सहायता से संपर्क करते समय, उसकी मार्गदर्शिका मॉडल, त्रुटि और कोड, अनुरोध डेटा और हेडर, टाइमस्टैम्प और टाइमज़ोन तथा अन्य प्रासंगिक जानकारी साझा करने की सलाह देती है; पहले गोपनीय कुंजियाँ और संवेदनशील डेटा हटा दें।
रीट्राई की स्पष्ट अधिकतम सीमा तय करें
रीट्राई तभी उपयोगी हैं जब विफलता अपने-आप ठीक हो सकती हो। विफलता लौटाने से पहले, अपने एप्लिकेशन के अधिकतम प्रयास और कुल समय की सीमा तय करें। दर-सीमा की प्रतिक्रिया मिलने पर, यदि Retry-After दिया गया हो तो उसका पालन करें और रीट्राई की संख्या सीमित रखें। सर्वर त्रुटियों के लिए मार्गदर्शिका थोड़ी देर इंतज़ार करने के बाद रीट्राई करने की सलाह देती है; समस्या बनी रहे तो स्थिति पृष्ठ देखें या सहायता के लिए आगे बढ़ाएँ। 401, गलत प्रारूप वाला अनुरोध या क्रेडिट समाप्त होने की प्रतिक्रिया अपने-आप रीट्राई करने का कारण नहीं है।
Python में आधिकारिक लाइब्रेरी AuthenticationError, BadRequestError, RateLimitError, APITimeoutError और InternalServerError जैसे अपवादों में अंतर करती है। आपके इंस्टॉल किए गए लाइब्रेरी संस्करण में उपलब्ध अपवाद वर्गों को संभालें और, जहाँ उपलब्ध हो, स्थिति और त्रुटि कोड दर्ज करें। नीचे दिया गया उदाहरण केवल समझाने के लिए है; यह वर्गीकरण दिखाता है, किसी परीक्षण किए गए कॉन्फ़िगरेशन या सार्वभौमिक रीट्राई नीति को नहीं:
from openai import OpenAI
client = OpenAI() # Supply credentials using your approved secret-management method.
try:
response = client.responses.create(
model="YOUR_SUPPORTED_MODEL",
input="Return the word ready."
)
text = response.output_text
if not isinstance(text, str) or not text.strip():
raise ValueError("Response text is missing or empty")
print(text)
except Exception as exc:
# In production, classify known SDK exceptions explicitly and log
# status/code when available. Do not log credentials or sensitive input.
print(type(exc).__name__, str(exc))
मॉडल प्लेसहोल्डर को ऐसे मॉडल से बदलना होगा जो आपके प्रोजेक्ट के लिए उपलब्ध हो। इस उदाहरण से यह साबित नहीं होता कि कोई विशेष मॉडल, पैरामीटर या प्रोवाइडर एंडपॉइंट आपके परिवेश में समर्थित है। यदि आप किसी अन्य संगत प्रोवाइडर का उपयोग करते हैं, तो समान व्यवहार मानने से पहले पुष्टि करें कि उसका एंडपॉइंट और पैरामीटर सपोर्ट आपके क्लाइंट कॉन्फ़िगरेशन से मेल खाता है।
गलत प्रारूप वाली प्रतिक्रियाओं को API त्रुटियों से अलग रखें
मान्य HTTP स्थिति से यह सुनिश्चित नहीं होता कि आपके एप्लिकेशन को अपेक्षित सामग्री मिली है। प्रतिक्रिया मिलते ही उसका सत्यापन करें: जाँचें कि पार्सिंग सफल है, आवश्यक फ़ील्ड मौजूद हैं और मान उपयोग योग्य प्रकार के हैं। प्रतिक्रिया की संवेदनशील सामग्री दिखाने के बजाय सत्यापन विफलता का संक्षिप्त विवरण लॉग करें—जैसे “output_text अनुपस्थित है” या “स्ट्रिंग अपेक्षित थी”।
यदि API संरचित त्रुटि लौटाता है, तो निदान जानकारी में उसकी स्थिति और कोड सुरक्षित रखें। यदि अनुरोध सफल होता है लेकिन आपका अपना पार्सर बॉडी को अस्वीकार करता है, तो उसे अलग श्रेणी में दर्ज करें। इससे स्पष्ट होता है कि API पहुँच या दर-सीमा, अनुरोध तैयार करने की प्रक्रिया, ट्रांसपोर्ट या एप्लिकेशन की मान्यताओं में से किसकी जाँच करनी है।
निष्कर्ष
OpenAI API का उपयोगी मूल्यांकन छोटा, दोहराने योग्य और सीमित होता है: एक आधारभूत जाँच, लक्षित विफलता मामले, आउटपुट की स्पष्ट जाँच और रीट्राई की तय अधिकतम सीमा। हर विफलता को दोबारा उत्पन्न करने के लिए पर्याप्त संदर्भ दर्ज करें और अगला कदम चुनते समय केवल HTTP स्थिति नहीं, बल्कि विशिष्ट त्रुटि कोड देखें।
सामान्य प्रश्न
क्या हर OpenAI 429 त्रुटि पर रीट्राई करना चाहिए?
नहीं। विशिष्ट त्रुटि कोड जाँचें। अस्थायी अनुरोध दर-सीमा के लिए अनुरोधों की गति नियंत्रित करना और `Retry-After` का पालन करना ज़रूरी हो सकता है; क्रेडिट समाप्त होने या खर्च और उपयोग की सीमाओं के लिए, रीट्राई से पहले उस सीमा का समाधान करें।
API विफलता और गलत प्रारूप वाली प्रतिक्रिया के बीच अंतर कैसे करें?
HTTP स्थिति और API त्रुटि कोड को एप्लिकेशन सत्यापन से अलग-अलग दर्ज करें। यदि सफल प्रतिक्रिया को पार्स न किया जा सके या उसमें आवश्यक फ़ील्ड न हो, तो यह प्रतिक्रिया-सत्यापन की समस्या है—ज़रूरी नहीं कि API त्रुटि हो।
लगातार बनी रहने वाली विफलता के लिए कौन-सी जानकारी इकट्ठा करनी चाहिए?
मॉडल, त्रुटि संदेश और कोड, अनुरोध का संदर्भ और संबंधित हेडर, टाइमज़ोन सहित टाइमस्टैम्प, प्रयासों की संख्या और लगा समय दर्ज करें। लॉग या सहायता विवरण साझा करने से पहले API कुंजियाँ और संवेदनशील डेटा छिपाएँ।
प्रोडक्शन को प्रभावित किए बिना दर-सीमा की जाँच कैसे करें?
`Retry-After` हेडर के अनुकरण सहित, नकली 429 प्रतिक्रिया से रीट्राई व्यवहार जाँचें। दर-सीमा सक्रिय करने के लिए प्रोडक्शन प्रोजेक्ट पर जानबूझकर बहुत अधिक अनुरोध न भेजें।
संबंधित लेख
Guides
JSON Schema एक्सट्रैक्शन में OpenAI API की समस्याओं का निदान
स्ट्रक्चर्ड एक्सट्रैक्शन पाइपलाइन में OpenAI प्रमाणीकरण, रेट लिमिट, टाइमआउट और अमान्य JSON की समस्याओं को हल करने के लिए व्यावहारिक वर्कफ़्लो।
Guides
GPT-5.6 Sol समीक्षा: DeepSeek और Qwen की तुलना में OpenAI के फ्लैगशिप मॉडल की आवश्यकता किसे है?
OpenAI के फ्लैगशिप मॉडल GPT-5.6 Sol की एक व्यावहारिक समीक्षा, जिसमें DeepSeek V4 और Qwen से तुलना, मूल्य निर्धारण, OpenAI API एकीकरण और इसका उपयोग किसे करना चाहिए, शामिल है।
Guides
GPT-5.6 Sol के साथ AI API लागत नियंत्रण: डेवलपर्स के लिए व्यावहारिक मार्गदर्शिका
OneMux के माध्यम से GPT-5.6 Sol का उपयोग करके OpenAI API लागतों को प्रभावी ढंग से प्रबंधित करना सीखें। मूल्य निर्धारण, लागत बचत रणनीतियों और मॉडल तुलना का अन्वेषण करें।
Guides
क्लॉड ओपस 4.7 क्यों है अभी कोडिंग के लिए सबसे बेहतरीन AI मॉडल
क्लॉड ओपस 4.7 बनाम GPT-5.4 की तुलना: कोड गुणवत्ता, तर्क और लागत। जानें कैसे OneMux आपको OpenAI API के माध्यम से दोनों मॉडलों तक एकीकृत पहुंच देता है।