GuidesOneMux

प्रोडक्शन में OpenAI API विफलताएँ: सुरक्षित तरीके से पहचानें, रीट्राई करें और रिकवर करें

OpenAI API की ऑथेंटिकेशन, रेट लिमिट, टाइमआउट, सर्वर और गलत फ़ॉर्मैट वाले रिस्पॉन्स की पहचान करने का व्यावहारिक प्रोडक्शन वर्कफ़्लो—और तय करें कि किसे रीट्राई करना है, किसे ठीक करना है या रिकवरी के लिए भेजना है।

AI

सारांश · TL;DR

प्रोडक्शन में त्रुटियों को संभालने की शुरुआत हर अनुरोध को रीट्राई करने से नहीं, बल्कि विफलता का वर्गीकरण करने से होती है। यह गाइड कॉन्फ़िगरेशन और कोटा संबंधी त्रुटियों को अस्थायी थ्रॉटलिंग, टाइमआउट, सर्वर विफलताओं और अमान्य रिस्पॉन्स से अलग करती है। इसमें सीमित JavaScript रीट्राई पैटर्न और सुरक्षित रिकवरी की चेकलिस्ट भी दी गई है।

मुख्य बातें

  • ऑथेंटिकेशन, अनुमति, गलत अनुरोध या क्रेडिट खत्म होने की त्रुटियों को कारण ठीक किए बिना रीट्राई न करें।
  • रेट लिमिट और ओवरलोड के मामले में, `Retry-After` उपलब्ध हो तो उसका पालन करें और एक्सपोनेंशियल बैकऑफ़ व जिटर के साथ रीट्राई की संख्या सीमित रखें।
  • टाइमआउट से यह साबित नहीं होता कि ऑपरेशन विफल हुआ; नॉन-आइडेम्पोटेंट काम को बिना सोचे दोबारा न दोहराएँ।
  • डाउनस्ट्रीम वर्कफ़्लो की स्थिति अपडेट करने से पहले सफल रिस्पॉन्स की पुष्टि करें और सुरक्षित रिकवरी के लिए पर्याप्त संदर्भ सुरक्षित रखें।
इस पृष्ठ पर (6)

प्रोडक्शन का नियम: रीट्राई से पहले वर्गीकरण करें

OpenAI API कॉल विफल होने पर उपयोगी सवाल सिर्फ़ “क्या मुझे रीट्राई करना चाहिए?” नहीं है। सवाल यह है: “कौन-सा साक्ष्य बताता है कि यह विफलता अस्थायी है, और डुप्लिकेट अनुरोध से क्या होगा?” प्रोडक्शन वर्कफ़्लो को त्रुटि का वर्गीकरण करना चाहिए, सीमित कार्रवाई करनी चाहिए और अगर सुरक्षित रूप से आगे बढ़ना संभव न हो, तो जॉब की स्थिति सुरक्षित रखनी चाहिए।

OpenAI ऑथेंटिकेशन त्रुटियों, रेट लिमिट, खत्म हुए क्रेडिट या खर्च की सीमाओं, सर्वर त्रुटियों और ओवरलोड हुए मॉडल के अलग-अलग कारण बताता है। सिर्फ़ स्टेटस कोड हमेशा पर्याप्त नहीं होता: त्रुटि कोड और संदेश भी देखें। दस्तावेज़ में बताए गए कारणों और उपायों के लिए OpenAI की error-codes गाइड देखें।

विफलता के प्रकार के अनुसार शुरुआती जाँच

लक्षणसंभावित कार्रवाईरीट्राई करें?
401 ऑथेंटिकेशन त्रुटिजाँचें कि API key सही और सक्रिय है, और अपेक्षित organization का इस्तेमाल हो रहा है। IP allowlisting कॉन्फ़िगर की हो, तो उसे भी जाँचें।नहीं—जब तक क्रेडेंशियल या ऐक्सेस ठीक न हो जाए।
400 bad requestसंदेश और अनुरोध के पैरामीटर जाँचें। इनमें आवश्यक इनपुट, एन्कोडिंग, फ़ॉर्मैट और आकार शामिल हैं।नहीं—जब तक अनुरोध ठीक न हो जाए।
429 रेट लिमिट या “धीमा करें”concurrency या अनुरोधों की दर कम करें। Retry-After उपलब्ध हो तो उसका पालन करें, फिर ट्रैफ़िक धीरे-धीरे बढ़ाएँ।हाँ—सीमित रीट्राई नीति के तहत।
429 क्रेडिट, खर्च या उपयोग की सीमाerror.code देखें; क्रेडिट फिर से जोड़ें या संबंधित सीमा का समाधान करें।नहीं। वही अनुरोध दोहराने से ऐक्सेस बहाल नहीं होगा।
500 सर्वर त्रुटि या 503 ओवरलोडथोड़ी देर प्रतीक्षा करें, Retry-After उपलब्ध हो तो उसका पालन करें और तय सीमा के भीतर रीट्राई करें।आम तौर पर हाँ, सुरक्षा उपायों के साथ।
क्लाइंट टाइमआउट या कनेक्शन त्रुटिनेटवर्क, प्रॉक्सी, TLS और फ़ायरवॉल की स्थिति जाँचें; पता लगाएँ कि अनुरोध पूरा हुआ हो सकता है या नहीं।कभी-कभी; पहले डुप्लिकेट प्रभावों का हिसाब रखें।
सफल स्टेटस, लेकिन अनुपयोगी रिस्पॉन्सवर्कफ़्लो आगे बढ़ाने से पहले रिस्पॉन्स का ढाँचा और ज़रूरी फ़ील्ड जाँचें।अपने-आप नहीं। इसे अलग डेटा-गुणवत्ता या प्रोटोकॉल विफलता की तरह संभालें।

OpenAI की गाइड के मुताबिक, Python का RateLimitError 429 और InternalServerError 503 के अनुरूप है; इसलिए ओवरलोड उस स्टेटस से अलग स्टेटस के साथ आ सकता है जिसकी किसी पुराने हैंडलर को उम्मीद हो। किसी भी क्लाइंट में, हर ओवरलोड को 429 मानने के बजाय स्टेटस और त्रुटि की जानकारी—दोनों का इस्तेमाल करें।

सीमित JavaScript रीट्राई पैटर्न

ज़रूरी शर्तें: OpenAI का मौजूदा JavaScript SDK, कॉन्फ़िगर की गई API key और ऐसा वर्कफ़्लो जो यह सुरक्षित रूप से तय कर सके कि अनुरोध दोहराना स्वीकार्य है या नहीं। यह उदाहरण सिर्फ़ चुनी हुई अस्थायी विफलताओं को रीट्राई करता है। इससे यह साबित नहीं होता कि टाइमआउट हुआ अनुरोध प्रोसेस नहीं किया गया था।

import OpenAI from "openai";

const client = new OpenAI();

const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

function retryAfterMs(error) {
  const value = error.headers?.get?.("retry-after");
  if (!value) return null;

  const seconds = Number(value);
  if (Number.isFinite(seconds)) return Math.max(0, seconds * 1000);

  const dateMs = Date.parse(value);
  return Number.isNaN(dateMs) ? null : Math.max(0, dateMs - Date.now());
}

function isRetryable(error) {
  const code = error.code;
  if ([
    "credit_balance_exhausted",
    "organization_spend_limit_exceeded",
    "project_spend_limit_exceeded",
    "organization_usage_limit_exceeded",
  ].includes(code)) return false;

  return error instanceof OpenAI.RateLimitError ||
    (error instanceof OpenAI.APIError &&
      [500, 503].includes(error.status));
}

async function createResponseWithRetry(input, maxRetries = 3) {
  for (let attempt = 0; ; attempt++) {
    try {
      return await client.responses.create({
        model: "YOUR_MODEL",
        input,
      });
    } catch (error) {
      if (!isRetryable(error) || attempt >= maxRetries) throw error;

      const exponentialMs = Math.min(10_000, 500 * 2 ** attempt);
      const jitterMs = Math.floor(Math.random() * 250);
      const delayMs = retryAfterMs(error) ?? exponentialMs + jitterMs;
      await sleep(delayMs);
    }
  }
}

YOUR_MODEL एक प्लेसहोल्डर है, मॉडल की सिफ़ारिश नहीं। यह उदाहरण रीट्राई नियंत्रण दिखाता है; हर SDK वर्ज़न या endpoint पर जाँचे गए व्यवहार की गारंटी नहीं देता। पुष्टि करें कि आपके इंस्टॉल किए गए वर्ज़न में SDK रिस्पॉन्स हेडर को इसी तरह उपलब्ध कराता है; ऐसा न हो तो उन्हें पढ़ने के लिए समर्थित तरीका अपनाएँ। रुकी हुई जॉब को अनिश्चित समय तक प्रतीक्षा करने से रोकने के लिए रीट्राई की संख्या के साथ-साथ वर्कफ़्लो-स्तर की समय-सीमा भी तय करें।

isRetryable में ऑथेंटिकेशन, bad-request, अनुमति या कोटा संबंधी त्रुटियाँ न जोड़ें। पहले कॉन्फ़िगरेशन या ऐक्सेस ठीक करें। हर जॉब के लिए रीट्राई बजट और क्यू-स्तर की concurrency सीमा पर भी विचार करें: अगर हर वर्कर तुरंत अनुरोध दोहराए, तो रीट्राई से ट्रैफ़िक का उछाल और बढ़ सकता है।

टाइमआउट और गलत फ़ॉर्मैट वाले रिस्पॉन्स के लिए रिकवरी नियम ज़रूरी हैं

टाइमआउट का अर्थ है कि क्लाइंट को समय पर रिस्पॉन्स नहीं मिला; इससे यह साबित नहीं होता कि सर्वर ने ऑपरेशन पूरा किया या नहीं। रीट्राई करने से पहले तय करें कि डुप्लिकेट काम स्वीकार्य है या नहीं। जिन जॉब के डाउनस्ट्रीम प्रभाव अहम हैं, उनके लिए जॉब पहचानकर्ता और प्रोसेसिंग स्थिति स्टोर करें, और जहाँ संभव हो डाउनस्ट्रीम राइट को आइडेम्पोटेंट बनाएँ। अगर नतीजे को लेकर अनिश्चितता हो, तो बिना सोचे-समझे काम दोहराने के बजाय जॉब को मिलान के लिए चिह्नित करें।

रिस्पॉन्स की पुष्टि को वर्कफ़्लो का अलग चरण मानें। जाँचें कि रिस्पॉन्स ऑब्जेक्ट मौजूद है, अपेक्षित सामग्री मिली है और कोई भी संरचित आउटपुट पार्स होकर आपके ऐप्लिकेशन के स्कीमा पर खरा उतरता है। पुष्टि में विफल रिस्पॉन्स को सफल नतीजे के रूप में दर्ज न करें। सुरक्षित निदान जानकारी रिकॉर्ड करें, फिर उसे सीमित सुधार या समीक्षा प्रक्रिया में भेजें; यह न मानें कि वही अनुरोध दोहराने से गलत फ़ॉर्मैट की समस्या ठीक हो जाएगी।

संचालन चेकलिस्ट

  1. समय और टाइमज़ोन, endpoint, मॉडल, HTTP स्टेटस, त्रुटि का प्रकार और कोड, और अनुरोध का सुरक्षित correlation identifier लॉग करें।
  2. API keys या संवेदनशील इनपुट कभी लॉग न करें। विफलता को सुरक्षित रूप से दोहराने के लिए जितनी अनुरोध जानकारी ज़रूरी हो, सिर्फ़ उतनी ही रखें।
  3. सिर्फ़ अस्थायी विफलताओं को रीट्राई करें; अधिकतम प्रयासों की संख्या, देरी, जिटर और कुल समय-सीमा तय करें।
  4. Retry-After दिया गया हो तो उसका पालन करें; थ्रॉटलिंग जारी रहे तो गति और कम करें।
  5. रीट्राई की सीमा पूरी होने की स्थिति को स्थायी विफलता से अलग रखें, ताकि ऑपरेटर जाँच कर सकें और पात्र जॉब फिर से चला सकें।
  6. लगातार बनी रहने वाली त्रुटियों के लिए मॉडल, त्रुटि संदेश और कोड, रहस्य हटाकर अनुरोध डेटा और हेडर, समय और टाइमज़ोन, तथा अन्य प्रासंगिक संदर्भ इकट्ठा करें। OpenAI सहायता टीम को ये विवरण देने की सलाह देता है।

निष्कर्ष

विश्वसनीय OpenAI API वर्कफ़्लो अस्थायी सेवा-दबाव और कॉन्फ़िगरेशन या सीमा में बदलाव माँगने वाली त्रुटियों के बीच अंतर करते हैं। थ्रॉटलिंग और सेवा विफलताओं को सावधानी से रीट्राई करें; ऑथेंटिकेशन और अनुरोध संबंधी त्रुटियाँ ठीक करें; और टाइमआउट व अमान्य आउटपुट को स्पष्ट रिकवरी स्थितियों के रूप में संभालें। यह वर्गीकरण रीट्राई लूप को एक विफल कॉल से बड़ी प्रोडक्शन घटना बनने से रोकता है।

सामान्य प्रश्न

क्या मुझे हर OpenAI API 429 रिस्पॉन्स को रीट्राई करना चाहिए?

नहीं। रेट लिमिट वाले रिस्पॉन्स को अंतराल रखकर, प्रयासों की संख्या सीमित करके और `Retry-After` उपलब्ध हो तो उसका पालन करके रीट्राई करें। क्रेडिट खत्म होने या खर्च अथवा उपयोग की सीमा के कारण आए 429 के लिए उस सीमा का समाधान करना होगा; कॉल दोहराने से ऐक्सेस बहाल नहीं होगा। त्रुटि कोड देखें।

वर्कफ़्लो को OpenAI API टाइमआउट कैसे संभालना चाहिए?

नतीजे को अनिश्चित मानें: प्रोसेसिंग पूरी होने के बावजूद क्लाइंट का टाइमआउट हो सकता है। रीट्राई करने से पहले डुप्लिकेट प्रभावों पर विचार करें, जहाँ संभव हो डाउनस्ट्रीम ऑपरेशन को आइडेम्पोटेंट बनाएँ और अस्पष्ट जॉब को मिलान प्रक्रिया में भेजें।

API गलत फ़ॉर्मैट वाला रिस्पॉन्स लौटाए, तो मुझे क्या करना चाहिए?

रिस्पॉन्स सेव करने या उस पर कार्रवाई करने से पहले उसका ढाँचा और ज़रूरी फ़ील्ड जाँचें। जॉब को सफल स्थिति में न डालें, सुरक्षित निदान जानकारी दर्ज करें और वही अनुरोध अपने-आप दोहराने के बजाय नियंत्रित सुधार या समीक्षा प्रक्रिया अपनाएँ।

क्या 503 का मतलब 429 जैसा ही होता है?

नहीं। दी गई OpenAI गाइड में 429 रेट लिमिट रिस्पॉन्स और 503 मॉडल ओवरलोड रिस्पॉन्स को अलग-अलग स्थितियाँ बताया गया है। क्लाइंट को स्टेटस और त्रुटि की जानकारी जाँचकर, ज़रूरत पड़ने पर दोनों को संभालना चाहिए—यह नहीं मानना चाहिए कि ओवरलोड हमेशा 429 के रूप में ही आएगा।

संबंधित लेख

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 के माध्यम से दोनों मॉडलों तक एकीकृत पहुंच देता है।

阅读全文 →

Guides

Claude Opus 4.7 बनाम GPT-5.5 बनाम Gemini 3.1 Pro: सॉफ्टवेयर इंजीनियरिंग के लिए कौन सा मॉडल बेस्ट है?

OpenAI GPT-5.5, Claude Opus 4.7, और Google Gemini 3.1 Pro की तुलना बेंचमार्क, मूल्य निर्धारण और वास्तविक दुनिया के कार्यों पर करें। जानें कि Opus 4.7 सॉफ्टवेयर इंजीनियरिंग में क्यों हावी है और OneMux आपको एकीकृत पहुंच कैसे देता है।

阅读全文 →