מגבלות השכבה החינמית של OpenRouter ואיך לתקן שגיאות 429

תשובה מהירה: מגבלות השכבה החינמית המדויקות

OpenRouter מגבילה שימוש חינמי בשני צירים: תקרת דקה ותקציב בקשות יומי. המגבלה לדקה עבור גרסאות מודל חינמיות (מזהי מודל שמסתיימים ב-:free) היא 20 בקשות לדקה. התקציב היומי תלוי בשאלה האם החשבון שלך אי פעם רכש לפחות $10 בקרדיטים: מתחת לסף הזה לכל החיים אתה מקבל 50 בקשות מודל חינמי ליום, בסף או מעליו אתה מקבל 1,000 ליום. אלה המספרים ש-OpenRouter מתעדת נכון לתחילת 2026. הם השתנו בעבר (התקרה היומית הייתה גבוהה יותר בעבר), אז התייחס לטבלה כאל בסיס נוכחי ולא כערבות קבועה, וודא מול המפתח שלך עם הבדיקה בסעיף הבא. תגובת 429 אומרת שחרגת מאחת מהמגבלות האלה, או שהספק במעלה הזרם שמגיש את המודל החינמי הזה נגמר לו קיבולת גם אם המכסה האישית שלך הייתה בסדר. שאר המדריך הזה מכסה איך לדעת באיזה מהם פגעת ומה לעשות בקשר לזה.

איך השכבה החינמית באמת עובדת

מודלים חינמיים ב-OpenRouter הם רשומות קטלוג נפרדות עם סיומת :free. הם מוגשים על ידי ספקים שתורמים או מסבסדים קיבולת, וזו הסיבה שהזמינות שלהם משתנה הרבה יותר מגרסאות בתשלום של אותם משקלים. שלושה פרטים מבלבלים אנשים. ראשית, התקרה היומית היא ברמת החשבון: 50 בקשות פזורות על פני כל תמהיל של מודלים חינמיים, לא 50 לכל מודל. שנית, סף ה-$10 סופר רכישות קרדיט לכל החיים, לא יתרה נוכחית. רכישת $10 פעם אחת שומרת אותך בסוגר 1,000 בקשות ליום גם אחרי שהוצאת אותם. שלישית, המגבלות נאכפות לפי חשבון, כך שיצירת מפתחות API נוספים תחת אותו חשבון לא מוסיפה כלום. אתה יכול לבדוק בדיוק איפה המפתח שלך עומד. התגובה כוללת is_free_tier, השימוש שלך עד כה, ואובייקט מגבלת הקצב שחל כרגע על המפתח שלך:

curl https://openrouter.ai/api/v1/auth/key \
  -H "Authorization: Bearer $OPENROUTER_API_KEY"

# Response fields worth reading:
# "is_free_tier": true    -> under the $10 lifetime threshold
# "usage": 1.42           -> credits consumed
# "rate_limit": {...}     -> the per-interval limit on this key

למה 429 קופצות בשעות עומס

המגבלות האישיות שלך הן רק חצי מהסיפור. קיבולת חינמית היא מאגר משותף, ו-OpenRouter יכולה לנתב בקשה חינמית רק לספק עם קיבולת מסובסדת פנויה באותו רגע. כשמודל חינמי פופולרי רווי, אתה מקבל 429 או שגיאות upstream גם אם שלחת רק כמה בקשות באותו יום. דיווחי קהילה מתארים באופן עקבי ערבים באזורי זמן אמריקאיים וסופי שבוע כחלונות הגרועים ביותר, כשאותה בקשה מצליחה מיד בשעות שקטות יותר. אלה תצפיות משוערות, לא מספרים מפורסמים, אך הן חוזרות מספיק כדי לתכנן סביבן. ממשקי צ'אט מגבירים את הבעיה. ממשקים בסגנון SillyTavern ו-JanitorAI שולחים בקשת השלמה חדשה לכל swipe, regenerate, ותור בצ'אט קבוצתי, וחלק מהגדרות proxy מנסות שוב אוטומטית על כשלים. משתמש שמרגיש שהוא שלח 15 הודעות אולי יצר 40 עד 50 בקשות, שזה כל התקציב היומי של חשבון מתחת לסף ה-$10. ניסיונות חוזרים אוטומטיים אגרסיביים גם מעמיקים את הגודש בשיא עבור כולם, וזו הסיבה שנסיגה ממושמעת חשובה. האבחון המעשי: אם ה-429 נעצרות כשאתה מחכה עד לאיפוס היומי, פגעת במכסה שלך. אם הן באות והולכות בתוך אותה שעה בעוד מספר הבקשות שלך נמוך, אתה רואה גודש במאגר.

תיקונים, לפי סדר מאמץ

אם אתה נשאר עם התעבורה על השכבה החינמית, הלקוח המינימלי הבר-קיימא מטפל ב-429 באופן מפורש במקום להיכשל או לנסות שוב בעיוורון:

• קרא את גוף השגיאה קודם. שגיאות 429 של OpenRouter מבחינות בין המגבלה לדקה שלך, המכסה היומית שלך שאזלה, וגודש upstream. תקן את זו שבאמת פגעת בה.
• כבד את Retry-After והיסוג באופן אקספוננציאלי עם jitter. הפצצת ה-endpoint שומרת אותך מוגבל יותר זמן ומחמירה את הגודש.
• חצה את סף ה-$10 קרדיט לכל החיים פעם אחת. זה מרים את התקרה היומית מ-50 ל-1,000 בקשות והוא התיקון בעל המינוף הגבוה ביותר עבור 429 של מכסה יומית.
• העבר את התעבורה שחשובה לגרסה בתשלום של אותו מודל. מודלים מסוג DeepSeek עולים הרבה מתחת לדולר למיליון טוקנים, כך שערב כבד של שימוש צ'אט בדרך כלל עולה סנטים.
• קצץ נפח בקשות בצד הלקוח: בטל רגנרציה אוטומטית, הימנע מ-swipes מיותרים, וקצר הקשר כך שכל ניסיון חוזר זול יותר כשהוא כן קורה.

import random
import time

import requests

def chat(payload: dict, key: str, retries: int = 5) -> dict:
    for attempt in range(retries):
        r = requests.post(
            "https://openrouter.ai/api/v1/chat/completions",
            headers={"Authorization": f"Bearer {key}"},
            json=payload,
            timeout=120,
        )
        if r.status_code != 429:
            r.raise_for_status()
            return r.json()
        wait = float(r.headers.get("Retry-After", 2 ** attempt + random.random()))
        time.sleep(wait)
    raise RuntimeError("Still rate limited after all retries")

חלופות כאשר 50 בקשות ליום לא מספיקות

אם דפוס השימוש שלך עקבית מעל התקציב החינמי, יש ארבעה מסלולים ריאליים. הנכון תלוי בשאלה האם צוואר הבקבוק שלך הוא המכסה היומית, גודש בשעות עומס, או שניהם. שים לב שהאפשרויות בתשלום נבדלות בעיקר בתקורה, לא בצורת הבקשה: כולן מדברות באותו פורמט chat completions תואם OpenAI, כך שהמעבר הוא שינוי base URL ומפתח ולא כתיבה מחדש.

הרצת ממשק צ'אט על שער ישיר

שער ישיר שומר על צורת הבקשה תואמת OpenAI אך מסיר את תור המאגר החינמי, כי כל בקשה היא קיבולת בתשלום. APIsRouter היא דוגמה אחת: תשלום לפי שימוש ללא מנוי, ו-checkout ללא הרשמה ב-/topup שבו אתה משלם קודם ומפתח ה-API מגיע במייל. מודלים גלובליים רצים 20% מתחת לרשימה הרשמית, מודלים סיניים נמצאים מתחת לתעריפים הרשמיים שלהם, וההטענה הראשונה מכפילה את היתרה ההתחלתית שלך. הגדרת ממשק הצ'אט משקפת את מה שאתה כבר עושה עם OpenRouter. ב-SillyTavern, הדבק את ה-base URL שמסתיים ב-/v1 (https://api.apisrouter.com/v1) ורשימת המודלים מתמלאת אוטומטית מ-/v1/models עם המפתח שלך. תצורת ה-proxy של JanitorAI צריכה במקום זאת את ה-endpoint המלא: https://api.apisrouter.com/v1/chat/completions, בתוספת שם המודל ומפתח ה-API. עבור תעבורת צ'אט דמויות ו-roleplay, משפחת DeepSeek V4 היא המועדפת על הקהילה מבחינת תמורה, עם MiMo, GLM-5, ו-Kimi K2.6 כבחירות תמורה נוספות. Claude Sonnet 4.6 כותב את הפרוזה החזקה ביותר לכתיבה יצירתית בטוחה לעבודה תחת מדיניות התוכן של Anthropic.

curl https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

שאלות נפוצות