GuidesOneMux

OpenAI API के प्रमाणीकरण, रेट-लिमिट, टाइमआउट और गलत फ़ॉर्मैट वाले रिस्पॉन्स की सुरक्षित जाँच कैसे करें

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

AI

सारांश · TL;DR

OpenAI API की विफलताओं का सबसे सुरक्षित निवारण यह है कि दोबारा कोशिश करने से पहले समस्या का प्रकार पहचानें। प्रमाणीकरण त्रुटियों में आम तौर पर key, organization, project या IP configuration ठीक करनी होती है; rate और quota संबंधी त्रुटियों के लिए अनुरोधों की गति नियंत्रित करनी पड़ती है या प्रशासनिक बदलाव करने होते हैं; टाइमआउट अस्थायी हो सकते हैं; और गलत फ़ॉर्मैट वाले रिस्पॉन्स को transport, proxy या parsing समस्या के रूप में अलग से जाँचना चाहिए। क्रेडेंशियल या उपयोगकर्ता की मूल सामग्री के बजाय केवल निदान के लिए ज़रूरी metadata लॉग करें।

मुख्य बातें

  • 401 प्रमाणीकरण विफलताओं या billing और quota संबंधी विफलताओं को अस्थायी नेटवर्क त्रुटियों की तरह बार-बार retry न करें।
  • 429 throttling और 503 overload responses के लिए, `Retry-After` उपलब्ध हो तो उसका पालन करें और सीमित exponential backoff लागू करें।
  • API keys को source code, logs, exception messages और client-side applications से दूर रखें।
  • Non-JSON response या असफल JSON parse को अलग transport या proxy समस्या मानें और केवल redacted, सीमित diagnostic जानकारी दर्ज करें।
  • लगातार बनी रहने वाली समस्या के लिए सहायता माँगते समय model, error code, timestamp, timezone और sanitized request details दें।
इस पृष्ठ पर (7)

OpenAI API की विफलताओं को ठीक करना आसान होता है, जब आप configuration errors, capacity errors, network failures और response parsing failures को अलग-अलग पहचानते हैं। निदान का पहला सवाल होना चाहिए: क्या retry करने से नतीजा बदलने की संभावना है?

आमतौर पर retry करने से 401 ठीक नहीं होता। अनुरोधों की गति के कारण आया 429, गति कम करने पर ठीक हो सकता है; लेकिन credits खत्म होने या spend limit पूरी होने के कारण आया 429, account या project में बदलाव माँगता है। टाइमआउट अस्थायी हो सकता है, पर बार-बार होने वाला टाइमआउट नेटवर्क, proxy या request size की समस्या का संकेत हो सकता है।

नीचे दी गई प्रक्रियाएँ JavaScript और आधिकारिक OpenAI library के उन concepts का उपयोग करती हैं जिनका वर्णन OpenAI error codes guide में है। यह code एक उदाहरणात्मक pattern है, production integration का परीक्षण किया हुआ रूप नहीं।

Debugging से पहले: credentials और उपयोगकर्ता डेटा सुरक्षित रखें

किसी त्रुटि को दोबारा उत्पन्न करने से पहले ये सावधानियाँ अपनाएँ:

  • API key को server-side secret manager या environment variable में रखें। इसे कभी भी browser code, mobile application, source control या support ticket में न रखें।
  • उपलब्ध होने पर request timestamp, endpoint category, model identifier, HTTP status और structured error code लॉग करें।
  • Authorization headers, पूरी request bodies, raw response bodies या व्यक्तिगत डेटा वाले prompts लॉग न करें।
  • अगर निदान के लिए prompt ज़रूरी हो, तो मूल text के बजाय redacted sample या स्थिर internal request identifier दर्ज करें।
  • Diagnostic payload की लंबाई सीमित रखें। Proxy एक बड़ा HTML error page लौटा सकता है और upstream error में ऐसा डेटा हो सकता है जिसे आप सहेजना नहीं चाहते।

कारगर संचालन नियम यह है कि logs से क्या और कहाँ विफल हुआ, यह पता चले—लेकिन उपयोगकर्ता ने क्या कहा या प्रमाणीकरण कैसे करना है, यह दर्ज न हो।

पहले 401 प्रमाणीकरण विफलताओं की जाँच करें

दस्तावेज़ में बताए गए 401 मामलों में invalid authentication, गलत API key, organization membership न होना और अनधिकृत IP address शामिल हैं। 403 का अर्थ यह हो सकता है कि देश, क्षेत्र या territory समर्थित नहीं है।

इन बिंदुओं को क्रम से जाँचें:

  1. पुष्टि करें कि server सही secret पढ़ रहा है और secret छोटा नहीं हो गया है, expire या revoke नहीं हुआ है, और उसकी जगह कोई दूसरा secret नहीं आया है।
  2. पुष्टि करें कि request सही API endpoint और project पर भेजी जा रही है।
  3. अगर आपके setup में organization identifier या IP allowlist है, तो project configuration से दोनों का मिलान करें।
  4. जाँचें कि development, container या hosted environment में request किसी अलग egress IP से तो नहीं आ रही।
  5. Logs साझा करने से पहले debug output से सभी credential values हटा दें।

401 या 403 के लिए automatic retries का उपयोग न करें। उसी invalid credential को बार-बार retry करने से अनावश्यक logs बन सकते हैं और incident की जाँच मुश्किल हो सकती है। Configuration ठीक करें, फिर नया request भेजें।

429 throttling को quota और billing विफलताओं से अलग पहचानें

हर 429 का मतलब “थोड़ी देर बाद फिर कोशिश करें” नहीं होता। OpenAI guide कई स्थितियों में फ़र्क बताती है:

विफलता की श्रेणीसंभावित कार्रवाईक्या अपने-आप retry करें?
Rate limit पूरी हो गईअनुरोधों की गति नियंत्रित करें और उपलब्ध होने पर Retry-After का पालन करेंहाँ, लेकिन सीमाओं के साथ
slow_downअनुरोधों की दर घटाएँ और धीरे-धीरे बढ़ाएँहाँ, सावधानी से
Credit balance खत्मCredits जोड़ेंनहीं
Organization या project की spend limitलागू limit बदलेंनहीं
Organization usage limitअधिक सीमा की मंज़ूरी माँगें या support से संपर्क करेंनहीं

Retry loop में हर 429 को एक जैसा मानने के बजाय HTTP status और विशिष्ट error code देखें। अधिकतम प्रयासों की संख्या तय करें, exponential backoff और jitter लागू करें, ताकि कई workers एक ही समय पर retry न करें। अगर Retry-After मौजूद है, तो अपनी अधिकतम प्रतीक्षा सीमा के अधीन उसी delay को प्राथमिकता दें।

503 responses को भी ध्यान में रखें। स्रोत दस्तावेज़ model overload के लिए server_is_overloaded बताता है और retry से पहले, उपलब्ध होने पर, Retry-After का पालन करने की सलाह देता है। Python library में overload को InternalServerError के रूप में दिखाया जा सकता है, जबकि 429 responses के लिए RateLimitError आता है; handlers को यह नहीं मानना चाहिए कि overload हमेशा 429 के रूप में ही आएगा।

टाइमआउट और connection failures की जाँच करें

आधिकारिक Python library में टाइमआउट हुए requests के लिए APITimeoutError और connection समस्याओं के लिए APIConnectionError का उल्लेख है। जाँच के लिए आम बिंदु ये हैं:

  • Response मिलने से पहले timeout: client timeout settings, network routes, proxies, firewalls और request size जाँचें।
  • Connection failure: DNS, TLS certificates, outbound firewall rules और proxy configuration जाँचें।
  • बार-बार server-side failures: service status page देखें और support के लिए sanitized timestamps सुरक्षित रखें।

टाइमआउट का यह प्रमाण नहीं है कि server ने request process नहीं किया। जिन operations में duplicate काम मायने रखता है, वहाँ application को इस तरह बनाएँ कि retry को सुरक्षित ढंग से मिलान किया जा सके—उदाहरण के लिए, operation को अपने request record से जोड़कर। Timeout का समाधान timeout को बिना सीमा बढ़ाना या अनिश्चितकाल तक retry करना नहीं है।

निजी सामग्री उजागर किए बिना गलत फ़ॉर्मैट वाले responses सँभालें

“Malformed response” कई तरह की समस्याओं के लिए इस्तेमाल हो सकता है: invalid request से मिला BadRequestError, अपेक्षित schema से मेल न खाने वाला response, या JSON के बजाय HTML अथवा अधूरा डेटा लौटाने वाला proxy। OpenAI guide के अनुसार BadRequestError malformed या incomplete request को दर्शाता है; इसमें आवश्यक parameters, encoding, format और size जाँचने की सलाह दी गई है।

Raw HTTP clients या middleware के लिए इन जाँचों को अलग रखें:

  1. Parse करने से पहले HTTP status और Content-Type जाँचें।
  2. JSON को guarded block के भीतर parse करें।
  3. इस्तेमाल करने से पहले जाँचें कि आवश्यक fields मौजूद हैं।
  4. केवल status, content type, response length और—अगर policy अनुमति दे—redacted तथा सीमित excerpt दर्ज करें।
  5. Parse error message में API key, पूरा prompt या पूरा response कभी शामिल न करें।

एक उदाहरणात्मक wrapper इस तरह दिख सकता है:

async function parseSafeResponse(response) {
  const contentType = response.headers.get("content-type") || "";
  const body = await response.text();

  if (!contentType.toLowerCase().includes("application/json")) {
    throw new Error(`Unexpected response type: ${contentType}; length=${body.length}`);
  }

  try {
    return JSON.parse(body);
  } catch {
    throw new Error(`Invalid JSON response; length=${body.length}`);
  }
}

यह उदाहरण जानबूझकर thrown error में body शामिल नहीं करता। Production में endpoint के अनुसार schema validation जोड़ें और raw payload को केवल नियंत्रित, privacy-reviewed diagnostic प्रक्रिया के तहत रखें।

गोपनीयता-सचेत error handler का pattern

आधिकारिक JavaScript उदाहरण connection errors, rate-limit errors और अन्य व्यापक API errors में फ़र्क करता है। उसी विचार को आगे बढ़ाते हुए errors को इस तरह वर्गीकृत करें कि secrets या उपयोगकर्ता की input print न हो:

import OpenAI from "openai";

const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });

try {
  const response = await client.responses.create({
    model: process.env.OPENAI_MODEL,
    input: "Redacted diagnostic input"
  });

  console.log({ ok: true, hasOutput: Boolean(response.output_text) });
} catch (error) {
  const details = {
    name: error?.name,
    status: error?.status,
    code: error?.code
  };

  if (error instanceof OpenAI.AuthenticationError) {
    console.error("Authentication failed", details);
  } else if (error instanceof OpenAI.RateLimitError) {
    console.error("Rate limit or quota response", details);
  } else if (error instanceof OpenAI.APIConnectionError) {
    console.error("Connection failed", details);
  } else if (error instanceof OpenAI.APIError) {
    console.error("OpenAI API error", details);
  } else {
    console.error("Unexpected local error", { name: details.name });
  }
}

आप जिस SDK version को deploy करते हैं, उसके class names और endpoint behavior की पुष्टि करें। यह न मानें कि provider-compatible हर endpoint सभी SDK parameters या response fields को support करता है।

सहायता के लिए कब संपर्क करें

लगातार बनी रहने वाली विफलताओं के लिए OpenAI guide model, error message और code, request data और headers, timestamp, timezone और अन्य प्रासंगिक जानकारी देने की सलाह देती है। यह जानकारी साझा करने से पहले उसे sanitize करें: credentials बदलें, cookies हटाएँ, व्यक्तिगत डेटा को redact करें और जहाँ संभव हो request body का सार दें। संवेदनशील जानकारी किसी public forum पर कभी पोस्ट न करें।

व्यावहारिक फैसला सरल है: प्रमाणीकरण और quota की समस्याएँ ठीक करें; throttling और overload पर backoff करें; टाइमआउट के लिए network boundaries जाँचें; और निजी payloads सहेजे बिना parsing failures को अलग से जाँचें।

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

क्या हर OpenAI 429 response को retry करना चाहिए?

नहीं। अनुरोधों की दर या slow-down से जुड़े responses को सावधानी से, backoff के साथ और `Retry-After` उपलब्ध होने पर उसका पालन करते हुए retry करें। Credits खत्म होने, spend limits या organization usage limits के ठीक होने की उम्मीद retries से न करें।

OpenAI overload error 429 के बजाय 503 के रूप में क्यों दिख सकता है?

OpenAI error guide model overload को `server_is_overloaded` code के साथ 503 के रूप में दर्ज करती है। Error handlers को status और code दोनों देखने चाहिए, यह नहीं मानना चाहिए कि overload हमेशा rate-limit response ही होगा।

OpenAI प्रमाणीकरण विफलता के लिए मुझे क्या लॉग करना चाहिए?

Timestamp, environment, endpoint category, status और sanitized error code लॉग करें। API key, `Authorization` header, पूरी request body या उपयोगकर्ता का raw prompt लॉग न करें।

Invalid JSON response की जाँच कैसे करूँ?

Parse करने से पहले HTTP status और `Content-Type` जाँचें। Policy अनुमति दे तो केवल सीमित और redacted diagnostic जानकारी दर्ज करें। उन proxies या middleware की जाँच करें जो HTML लौटा सकते हैं, डेटा छोटा कर सकते हैं या response बदल सकते हैं।

संबंधित लेख

Guides

मानवीय अनुमोदन वाले सपोर्ट ट्रायेज़ वर्कफ़्लो में OpenAI API विफलताओं का निदान

ग्राहकों तक विफल ट्रायेज़ पहुँचने से रोकते हुए authentication errors, rate limits, timeouts और malformed model responses को संभालने की व्यावहारिक मार्गदर्शिका।

阅读全文 →

Guides

दस्तावेज़ों से सवाल-जवाब में OpenAI API की विफलताओं का निदान

ऑथेंटिकेशन, रेट लिमिट, टाइमआउट और गलत स्रोत-संदर्भ वाले जवाबों के लिए एक व्यावहारिक समस्या-निवारण गाइड।

阅读全文 →

Guides

ग्राहक सहायता ट्रायेज के लिए OpenAI API कुंजियाँ सुरक्षित रखें

ग्राहक सहायता ट्रायेज में OpenAI के सुरक्षित उपयोग की व्यावहारिक प्रक्रिया: API कुंजियों की सुरक्षा करें, लॉग से संवेदनशील जानकारी हटाएँ, अनुमतियाँ सीमित रखें, क्रेडेंशियल बदलें और मानव अनुमोदन अनिवार्य करें।

阅读全文 →

Guides

Document-Q&A वर्कफ़्लो में OpenAI API Keys को सुरक्षित रखें

OpenAI के साथ document question answering के लिए एक व्यावहारिक सुरक्षा तरीका: क्रेडेंशियल अलग रखें, अनुमतियाँ सीमित करें, लॉग से संवेदनशील जानकारी हटाएँ और स्रोत attribution बनाए रखते हुए keys को सुरक्षित रूप से rotate करें।

阅读全文 →