Mga limitasyon ng OpenRouter free tier at paano ayusin ang 429 errors

Mabilis na sagot: ang eksaktong limitasyon ng free tier

Nili-limit ng OpenRouter ang libreng paggamit sa dalawang axis: isang per-minute na ceiling at isang daily request budget. Ang per-minute na limitasyon para sa mga libreng variant ng model (mga model ID na nagtatapos sa :free) ay 20 request bawat minuto. Nakadepende ang daily budget kung nakabili na ba kailanman ang iyong account ng kahit $10 sa credits: kung mas mababa sa lifetime threshold na iyon nakakakuha ka ng 50 request sa libreng model bawat araw, kung katumbas o lampas dito nakakakuha ka ng 1,000 bawat araw. Ito ang mga figure na dinodokumento ng OpenRouter simula unang bahagi ng 2026. Nagbago na ito noon (mas mataas dati ang daily cap), kaya ituring ang talahanayan bilang kasalukuyang baseline sa halip na permanenteng garantiya, at i-verify laban sa sarili mong key gamit ang check sa susunod na seksyon. Ang tugon na 429 ay nangangahulugang nalampasan mo ang isa sa mga cap na ito, o naubusan ng kapasidad ang upstream na provider na nagsisilbi sa libreng model na iyon kahit maayos ang personal mong quota. Sinasaklaw ng natitirang bahagi ng gabay na ito kung paano malalaman kung alin ang natamaan mo at kung ano ang gagawin dito.

Paano talaga gumagana ang free tier

Ang mga libreng model sa OpenRouter ay hiwalay na entry sa catalog na may :free suffix. Ini-serve ang mga ito ng mga provider na nagdo-donate o nagsu-subsidize ng kapasidad, kaya mas malaki ang galaw ng availability nito kaysa sa paid na variant ng parehong weights. May tatlong detalye na nagpapatalisod sa mga tao. Una, ang daily cap ay account-wide: 50 request na kinakalat sa kahit anong halo ng mga libreng model, hindi 50 bawat model. Pangalawa, binibilang ng $10 na threshold ang lifetime na pagbili ng credit, hindi ang kasalukuyang balanse. Ang pagbili ng $10 nang isang beses ay pinapanatili kang nasa 1,000 requests per day bracket kahit gastusin mo na ito. Pangatlo, ipinapatupad ang mga limitasyon bawat account, kaya walang idinaragdag ang paggawa ng dagdag na API key sa parehong account. Puwede mong tingnan nang eksakto kung nasaan ang iyong key. Kasama sa tugon ang is_free_tier, ang iyong usage sa ngayon, at ang rate limit object na kasalukuyang ipinapatupad sa iyong key:

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

# Mga field sa tugon na dapat basahin:
# "is_free_tier": true    -> nasa ilalim ng $10 lifetime threshold
# "usage": 1.42           -> nagamit na credits
# "rate_limit": {...}     -> ang per-interval na limitasyon sa key na ito

Bakit tumataas ang 429 sa peak hours

Kalahati lamang ng kwento ang iyong personal na mga cap. Isang shared na pool ang free capacity, at puwede lamang mag-route ang OpenRouter ng libreng request sa isang provider na may sobrang subsidized na kapasidad sa sandaling iyon. Kapag naging saturated ang isang popular na libreng model, makukuha mo ang 429 o mga upstream error kahit ilang request lang ang nagawa mo ngayong araw. Patuloy na inilalarawan ng mga ulat ng community ang mga gabi sa US time zones at mga weekend bilang ang pinakamasamang oras, na may parehong request na nagtatagumpay agad sa off-peak na oras. Mga tinatayang obserbasyon iyon, hindi inilathalang numero, ngunit paulit-ulit itong nangyayari nang sapat para planuhin sa paligid nito. Pinalalaki ng mga chat frontend ang problema. Nagpapadala ang mga interface na estilong SillyTavern at JanitorAI ng bagong completion request para sa bawat swipe, regenerate, at group chat turn, at ang ilang proxy setup ay awtomatikong nag-re-retry ng mga pagkabigo. Ang isang user na pakiramdam ay nagpadala ng 15 mensahe ay maaaring nakabuo na ng 40 hanggang 50 request, na siyang buong daily budget ng account na mas mababa sa $10 threshold. Ang agresibong awtomatikong retry ay nagpapalalim din ng peak congestion para sa lahat, kaya mahalaga ang disiplinadong backoff. Ang praktikal na diagnostic: kung tumitigil ang 429 kapag naghintay ka hanggang sa daily reset, natamaan mo ang iyong quota. Kung dumarating at nawawala ang mga ito sa loob ng parehong oras habang mababa ang iyong request count, nakikita mo ang pool congestion.

Mga ayos, ayon sa antas ng pagsisikap

Kung pinapanatili mo ang traffic sa free tier, hinahawakan ng minimum viable na client ang 429 nang malinaw sa halip na basta bumigo o bulag na mag-retry:

• Basahin muna ang error body. Ipinapakita ng OpenRouter 429 ang pagkakaiba ng iyong per-minute na limitasyon, ang naubos mong daily quota, at ang upstream congestion. Ayusin ang aktwal na natamaan mo.
• Igalang ang Retry-After at mag-back off nang exponential na may jitter. Ang paulit-ulit na pagtama sa endpoint ay nagpapatagal sa iyong pagiging rate limited at pinapalala ang congestion.
• Lampasan nang isang beses ang $10 lifetime credit threshold. Itinataas nito ang daily cap mula 50 patungong 1,000 request at ito ang solong pinaka-mabisang ayos para sa 429 na dulot ng daily quota.
• Ilipat ang mahalagang traffic sa paid na variant ng parehong model. Ang mga DeepSeek-class na model ay nagkakahalaga ng malayong mas mababa sa isang dolyar bawat milyong token, kaya ang isang mabigat na gabi ng chat ay karaniwang sentimo lamang ang gastos.
• Bawasan ang request volume sa client: i-disable ang auto-regeneration, iwasan ang hindi kailangang swipe, at putulin ang context para mas mura ang bawat retry kapag nangyari ito.

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")

Mga alternatibo kapag hindi sapat ang 50 requests bawat araw

Kung palaging nasa itaas ng free budget ang iyong pattern ng paggamit, may apat na makatotohanang landas. Ang tamang isa ay nakadepende kung ang iyong bottleneck ay ang daily quota, peak-hour congestion, o pareho. Tandaan na ang mga paid na opsyon ay nagkakaiba pangunahin sa overhead, hindi sa hugis ng request: lahat sila ay nagsasalita ng parehong OpenAI-compatible na chat completions na format, kaya ang paglipat ay isang pagbabago sa base URL at key sa halip na isang rewrite.

Pagpapatakbo ng chat frontend sa direktang gateway

Pinapanatili ng direktang gateway ang hugis ng OpenAI-compatible na request ngunit inaalis ang queue ng free-pool, dahil ang bawat request ay paid na kapasidad. Ang APIsRouter ay isang halimbawa: pay as you go na walang subscription, at isang checkout na walang signup sa /topup kung saan magbabayad ka muna at darating ang API key sa email. Ang mga global na model ay tumatakbo 20% na mas mababa kaysa sa opisyal na listahan ng presyo, ang mga Chinese na model ay nasa ilalim ng kanilang opisyal na rate, at dinodoble ng unang top-up ang iyong panimulang balanse. Sinasalamin ng frontend setup ang ginagawa mo na sa OpenRouter. Sa SillyTavern, i-paste ang base URL na nagtatapos sa /v1 (https://api.apisrouter.com/v1) at awtomatikong pupunuin ang model list mula sa /v1/models gamit ang iyong key. Kailangan naman ng configuration ng proxy ng JanitorAI ang buong endpoint: https://api.apisrouter.com/v1/chat/completions, kasama ang pangalan ng model at ang API key. Para sa character chat at roleplay na traffic, ang DeepSeek V4 family ang paborito ng community para sa value, na may MiMo, GLM-5, at Kimi K2.6 bilang karagdagang value picks. Isinusulat ng Claude Sonnet 4.6 ang pinakamalakas na prose para sa safe-for-work na creative writing sa ilalim ng content policy ng 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"}]
  }'

Mga madalas itanong