Ліміти безкоштовного тарифу OpenRouter і як виправити помилки 429

Швидка відповідь: точні ліміти безкоштовного тарифу

OpenRouter обмежує безкоштовне використання за двома осями: стеля на хвилину і щоденний бюджет запитів. Ліміт на хвилину для безкоштовних варіантів моделей (ID моделей, що закінчуються на :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 чи помилки вище за потоком, навіть якщо зробили лише кілька запитів за день. Повідомлення спільноти послідовно описують вечори за американським часом і вихідні як найгірші вікна, при цьому той самий запит успішно проходить одразу в непіковий час. Це приблизні спостереження, а не опубліковані цифри, але вони повторюються достатньо часто, щоб на них орієнтуватися. Чат-фронтенди підсилюють цю проблему. Інтерфейси на кшталт SillyTavern і JanitorAI надсилають новий запит завершення на кожен свайп, регенерацію і хід групового чату, а деякі проксі-налаштування автоматично повторюють невдалі спроби. Користувач, який відчуває, ніби надіслав 15 повідомлень, міг згенерувати 40-50 запитів, а це весь щоденний бюджет акаунта нижче порогу в $10. Агресивні автоматичні повтори також поглиблюють пікове перевантаження для всіх, тому дисциплінований відкат має значення. Практична діагностика: якщо 429 припиняються, коли ви чекаєте до щоденного скидання, ви досягли своєї квоти. Якщо вони то з'являються, то зникають протягом однієї години при низькій кількості запитів, ви бачите перевантаження пулу.

Способи виправлення, за зростанням зусиль

Якщо ви лишаєте трафік на безкоштовному тарифі, мінімально життєздатний клієнт обробляє 429 явно, а не провалюється чи наосліп повторює спроби:

• Спершу прочитайте тіло помилки. Помилки 429 в OpenRouter розрізняють ваш ліміт на хвилину, вичерпану щоденну квоту і перевантаження вище за потоком. Виправляйте саме те, що сталося.
• Поважайте Retry-After і робіть експоненційний відкат із джитером. Безперервні удари по ендпоінту тримають вас у обмеженні довше і посилюють перевантаження.
• Один раз перетніть поріг у $10 довічних кредитів. Це піднімає щоденний ліміт з 50 до 1 000 запитів і є найефективнішим виправленням для 429, спричинених щоденною квотою.
• Перенесіть важливий трафік на платний варіант тієї самої моделі. Моделі класу DeepSeek коштують значно менше долара за мільйон токенів, тож інтенсивний вечір чату зазвичай коштує центи.
• Скоротіть обсяг запитів на клієнті: вимкніть автоматичну регенерацію, уникайте зайвих свайпів і скоротіть контекст, щоб кожна повторна спроба була дешевшою, коли вона все ж стається.

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 запитів на день не вистачає

Якщо ваш патерн використання постійно перевищує безкоштовний бюджет, є чотири реалістичні шляхи. Правильний вибір залежить від того, що саме є вашим вузьким місцем: щоденна квота, пікове перевантаження чи обидва. Варто зауважити, що платні варіанти відрізняються здебільшого за накладними витратами, а не за формою запиту: усі вони говорять тим самим OpenAI-сумісним форматом chat completions, тож перехід це зміна базового URL і ключа, а не переписування коду.

Запуск чат-фронтенду на прямому шлюзі

Прямий шлюз зберігає OpenAI-сумісну форму запиту, але прибирає чергу безкоштовного пулу, бо кожен запит це платна потужність. APIsRouter один із прикладів: оплата за фактом використання без підписки, і чекаут без реєстрації на /topup, де ви платите першими, а API-ключ надходить на email. Глобальні моделі коштують на 20% нижче офіційного прайсу, китайські моделі нижче своїх офіційних тарифів, а перше поповнення подвоює стартовий баланс. Налаштування фронтенду повторює те, що ви вже робите з OpenRouter. У SillyTavern вставте базовий URL, що закінчується на /v1 (https://api.apisrouter.com/v1), і список моделей автоматично заповнюється з /v1/models разом із вашим ключем. Конфігурація проксі JanitorAI натомість потребує повний ендпоінт: https://api.apisrouter.com/v1/chat/completions, плюс назву моделі та API-ключ. Для чату з персонажами й рольового трафіку родина DeepSeek V4 фаворит спільноти за співвідношенням ціна/якість, а MiMo, GLM-5 і Kimi K2.6 додаткові варіанти за цим критерієм. Claude Sonnet 4.6 пише найсильнішу прозу для прийнятного для роботи (SFW) творчого письма за політикою контенту 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"}]
  }'

Поширені запитання