מגבלות קצב ושגיאות

429 יכול להגיע מכמה שכבות:

• התקרה שלנו למודלים חינמיים: בקשה אחת לדקה, לכל מודל חינמי, לכל משתמש.
• מגבלות במעלה הזרם: הספק שמאחורי מודל חינמי הגיע לתקרה שלו.
• תקציבי טוקנים יומיים בחלק מהמאגרים החינמיים, מתאפסים בחצות UTC.
• תקרות טוקנים לדקה, שמופעלות על ידי הנחיות גדולות מאוד.
• מגבלת מקביליות לכל משתמש על בקשות במקביל.

למודלים בתשלום אין מגבלות קצב שמוטלות על ידי UnoRouter.

כשהתקרה של בקשה אחת לדקה מופעלת אתם מקבלים כותרות מגבלת קצב תקניות:

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.

התקרה חלה על המסלול החינמי בלבד. המודל בתשלום מקבל הנחיות באורך מלא.

שגיאות מוחזרות כ-JSON בפורמט השגיאות של OpenAI. השדה code הוא מזהה יציב. מזהה בקשה מצורף לכל הודעה:

{
  "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"
  }
}

כללו את מזהה הבקשה בפניות לתמיכה. הוא מאתר את הבקשה שלכם ביומנים.

אם אתה עדיין מגדיר את המפתח או כתובת הבסיס, התחל ב התחלה מהירה

קודי הסטטוס שבאמת תיתקל בהם:

שני מצבים שונים מאוד חולקים את סטטוס 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 שלישי כשרק הקבוצות המוצמדות שלכם נפלו, ראו הצמדת קבוצות

כבדו את Retry-After בשגיאת 429. נסו שוב 503 get_channel_failed אחרי המתנה קצרה, או החליפו מודל. אל תנסו שוב שגיאות ממחלקת 400.

בקשות שנכשלו או נדחו לעולם אינן מחויבות; איך עובדים העיכוב המקדים וההחזר מוסבר ב חשבון וחיוב