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

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

• हमारी मुफ़्त मॉडल सीमा: हर उपयोगकर्ता, हर मुफ़्त मॉडल पर 1 अनुरोध प्रति मिनट।
• ऊपर की सीमाएँ: किसी मुफ़्त मॉडल के पीछे बैठा प्रदाता अपनी ही सीमा से टकरा गया।
• कुछ मुफ़्त समूहों पर रोज़ का टोकन बजट, जो 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।

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

त्रुटियाँ 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"
  }
}

सहायता टिकट में अनुरोध id ज़रूर दें। इससे लॉग में आपका अनुरोध ढूँढ़ा जाता है।

यदि आप अब भी अपनी कुंजी या बेस URL सेट कर रहे हैं, तो शुरुआत यहाँ से करें क्विकस्टार्ट

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

दो बहुत भिन्न स्थितियाँ स्टेटस 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 को दोबारा कोशिश करने लायक और model_not_found को पक्की त्रुटि मानें।

लोड में गायब हुआ मॉडल अपने आप लौटता है; लौटते ही सूचना पाने के लिए इसे यहाँ देखें सूचनाएँ

यदि आपकी कुंजी प्रदाता समूह पिन करती है, तो तीसरा 503 तब आता है जब केवल आपके पिन किए समूह डाउन हों, देखें समूह पिनिंग

429 पर Retry-After का पालन करें। 503 get_channel_failed पर थोड़ी देर बाद दोबारा कोशिश करें, या मॉडल बदलें। 400 श्रेणी की त्रुटियाँ दोबारा न भेजें।

विफल और अस्वीकृत अनुरोधों का कभी बिल नहीं बनता; प्री-होल्ड और रिफ़ंड की प्रक्रिया यहाँ है खाता और बिलिंग