त्रुटियाँ और दर सीमाएँ

त्रुटियाँ OpenAI त्रुटि प्रारूप में JSON के रूप में लौटती हैं। संदेश बताता है कि क्या हुआ, code एक स्थिर, मशीन-पठनीय पहचानकर्ता है, और हर संदेश में एक अनुरोध id जोड़ा जाता है:

{
  "error": {
    "message": "Model \"gpt-5.5-typo\" is not offered here. Check the model name for typos, or switch to a model from our supported list. (request id: 20260705...)",
    "type": "new_api_error",
    "code": "model_not_found"
  }
}

जब आप सहायता से संपर्क करें या Discord टिकट खोलें तो हमेशा अनुरोध id शामिल करें। यह हमें लॉग में आपका सटीक अनुरोध खोजने देता है।

वे स्टेटस कोड जिनका आप वास्तव में सामना करेंगे:

दो बहुत भिन्न स्थितियाँ स्टेटस 503 साझा करती हैं। पहली एक अस्थायी भीड़ है:

HTTP/1.1 503 Service Unavailable

{
  "error": {
    "message": "All providers for model \"kimi-k2.6:free\" are busy right now (they hit their rate limit). This is not a spelling error. Please try again in a little while, or switch to another model. (request id: 20260705...)",
    "type": "new_api_error",
    "code": "get_channel_failed"
  }
}

कोड get_channel_failed (सभी प्रदाता व्यस्त) का अर्थ है कि उस मॉडल के लिए हर मुफ़्त प्रदाता क्षण भर के लिए दर-सीमित है। यह मिनटों में स्वतः ठीक हो जाता है: पुनः प्रयास करें या मॉडल स्विच करें। कोड model_not_found (यहाँ पेश नहीं किया गया) का अर्थ है कि मॉडल नाम स्वयं रिज़ॉल्व नहीं होता, और पुनः प्रयास कभी मदद नहीं करेगा। टाइपो जाँचें या कैटलॉग में वर्तमान नाम खोजें।

get_channel_failed वाले 503 को पुनः प्रयास/फ़ॉलबैक के रूप में और model_not_found वाले 503 को अपने क्लाइंट में एक हार्ड त्रुटि के रूप में मानें।

एक 429 कई परतों से आ सकता है:

• हमारी मुफ़्त-मॉडल सीमा: प्रति उपयोगकर्ता प्रति मुफ़्त मॉडल प्रति मिनट 1 अनुरोध। एक निष्पक्षता सीमा ताकि साझा पूल व्यस्त घंटों में टिके रहें।
• अपस्ट्रीम प्रदाता सीमाएँ: मुफ़्त मॉडल के पीछे के प्रदाता ने अपनी सीमा पर पहुँच गया ("temporarily rate-limited upstream", यानी अपस्ट्रीम पर अस्थायी रूप से दर-सीमित)।
• कुछ मुफ़्त पूल पर दैनिक टोकन बजट; ये UTC मध्यरात्रि पर रीसेट होते हैं।
• प्रति-मिनट-टोकन सीमाएँ जो बहुत बड़े प्रॉम्प्ट पर सक्रिय होती हैं।
• जब बहुत सारे अनुरोध समानांतर में चलते हैं तो प्रति-उपयोगकर्ता समवर्ती सीमा।

भुगतान वाले मॉडलों पर UnoRouter द्वारा लगाई गई कोई दर सीमा नहीं है।

जब हमारी प्रति-मिनट-1 सीमा सक्रिय होती है तो आपको मानक दर-सीमा हेडर मिलते हैं, ताकि क्लाइंट सटीक रूप से बैक ऑफ़ कर सकें:

HTTP/1.1 429 Too Many Requests
Retry-After: 38
X-RateLimit-Limit: 1
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1783198478

Retry-After गतिशील है: आपकी विंडो में वास्तव में शेष सेकंड, न कि एक निश्चित 60। त्रुटि संदेश मॉडल के भुगतान वाले जुड़वाँ का नाम भी बताता है, जिसकी कोई सीमा नहीं है।

कुछ सामान्यतः भुगतान वाले मॉडल एक अनुरोध आकार सीमा के साथ मुफ़्त पेश किए जाते हैं। बहुत बड़े प्रॉम्प्ट को इस तरह के संदेश के साथ 413 मिलता है: Request body too large for gpt-4.1 model. Max size: 8000 tokens.

यह सीमा केवल मुफ़्त ट्रायल मार्ग पर लागू होती है; भुगतान वाला मॉडल पूर्ण-लंबाई के प्रॉम्प्ट लेता है।

429 पर Retry-After का सम्मान करें। 503 get_channel_failed को थोड़ी प्रतीक्षा के बाद पुनः प्रयास करें, या किसी अन्य मॉडल पर फ़ॉलबैक करें। 400-श्रेणी की त्रुटियों को पुनः प्रयास न करें, वे नियतात्मक हैं।

विफल और अस्वीकृत अनुरोधों का बिल नहीं बनता: जब अनुरोध त्रुटि देता है तो आपके बैलेंस पर कोई भी पूर्व-होल्ड वापस कर दिया जाता है।