OpenRouter gratis tier limieten en hoe je 429-fouten oplost

Kort antwoord: de exacte limieten van de gratis tier

OpenRouter begrenst gratis gebruik op twee assen: een plafond per minuut en een dagelijks verzoekbudget. Het plafond per minuut voor gratis modelvarianten (model-ID's eindigend op :free) is 20 verzoeken per minuut. Het dagelijkse budget hangt af van of je account ooit ten minste $10 aan tegoed heeft gekocht: onder die levenslange drempel krijg je 50 gratis-modelverzoeken per dag, erop of erboven krijg je er 1.000 per dag. Dit zijn de cijfers die OpenRouter documenteert vanaf begin 2026. Ze zijn eerder gewijzigd (het dagplafond lag ooit hoger), dus zie de tabel als de huidige basislijn en niet als een permanente garantie, en verifieer tegen je eigen sleutel met de check in de volgende sectie. Een 429-response betekent dat je een van deze plafonds overschreed, of dat de upstream-provider die dat gratis model levert zonder capaciteit zat terwijl je persoonlijke quotum prima was. De rest van deze gids behandelt hoe je herkent welke van de twee je raakte en wat je eraan doet.

Hoe de gratis tier daadwerkelijk werkt

Gratis modellen op OpenRouter zijn aparte catalogusvermeldingen met een :free-achtervoegsel. Ze worden geleverd door providers die capaciteit doneren of subsidiëren, wat verklaart waarom hun beschikbaarheid veel sterker schommelt dan betaalde varianten van dezelfde gewichten. Drie details struikelen mensen. Ten eerste is het dagplafond accountbreed: 50 verzoeken verspreid over elke mix van gratis modellen, niet 50 per model. Ten tweede telt de drempel van $10 levenslang gekochte tegoeden, niet je huidige saldo. Eenmalig $10 kopen houdt je in het bracket van 1.000 verzoeken per dag, ook nadat je het hebt uitgegeven. Ten derde worden limieten per account gehandhaafd, dus extra API-sleutels aanmaken onder hetzelfde account voegt niets toe. Je kunt precies controleren waar je sleutel staat. De response bevat is_free_tier, je gebruik tot nu toe, en het rate-limitobject dat momenteel op je sleutel van toepassing is:

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

# Responsevelden die het lezen waard zijn:
# "is_free_tier": true    -> onder de levenslange drempel van $10
# "usage": 1.42           -> verbruikte credits
# "rate_limit": {...}     -> de limiet per interval voor deze sleutel

Waarom 429's pieken op piekuren

Je persoonlijke plafonds zijn maar de helft van het verhaal. Gratis capaciteit is een gedeelde pool, en OpenRouter kan een gratis verzoek alleen routeren naar een provider met vrije gesubsidieerde capaciteit op dat moment. Wanneer een populair gratis model verzadigd raakt, krijg je 429- of upstream-fouten, zelfs als je die dag maar een handvol verzoeken hebt gedaan. Communityrapporten beschrijven consequent avonden in Amerikaanse tijdzones en weekenden als de slechtste momenten, waarbij hetzelfde verzoek op rustige uren meteen slaagt. Dat zijn indicatieve observaties, geen gepubliceerde cijfers, maar ze komen vaak genoeg terug om erop te plannen. Chat-frontends versterken het probleem. Interfaces in de stijl van SillyTavern en JanitorAI sturen bij elke swipe, regenerate en groepschatbeurt een nieuw completion-verzoek, en sommige proxy-opstellingen doen automatisch opnieuw pogingen bij fouten. Een gebruiker die het gevoel heeft 15 berichten te hebben verstuurd, kan 40 tot 50 verzoeken hebben gegenereerd, wat het volledige dagelijkse budget is van een account onder de drempel van $10. Agressieve automatische retries verdiepen ook de piekcongestie voor iedereen, waarom gedisciplineerde backoff ertoe doet. De praktische diagnose: als 429's stoppen zodra je wacht tot de dagelijkse reset, heb je je quotum geraakt. Als ze binnen hetzelfde uur komen en gaan terwijl je verzoeksaantal laag is, zie je poolcongestie.

Oplossingen, in volgorde van inspanning

Blijf je verkeer op de gratis tier houden, dan behandelt de minimaal levensvatbare client 429 expliciet in plaats van te falen of blind te retryen:

• Lees eerst de foutmelding. OpenRouter 429's maken onderscheid tussen je limiet per minuut, je uitgeputte dagelijkse quotum, en upstream-congestie. Los op wat je daadwerkelijk raakte.
• Respecteer Retry-After en bouw exponentieel af met jitter. Het endpoint blijven bestoken houdt je langer rate-limited en verergert de congestie.
• Passeer eenmalig de levenslange drempel van $10 tegoed. Dat tilt het dagplafond van 50 naar 1.000 verzoeken en is de fix met de meeste hefboomwerking voor 429's door dagquota.
• Verplaats het verkeer dat ertoe doet naar een betaalde variant van hetzelfde model. Modellen uit de DeepSeek-klasse kosten ruim onder een dollar per miljoen tokens, dus een zware avond chatten kost meestal centen.
• Verlaag het verzoeksvolume aan clientzijde: schakel auto-regeneratie uit, vermijd onnodige swipes, en kort de context in zodat elke retry, als die zich voordoet, goedkoper is.

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

Alternatieven wanneer 50 verzoeken per dag niet genoeg is

Als jouw gebruikspatroon consequent boven het gratis budget uitkomt, zijn er vier realistische paden. Welke de juiste is, hangt af van of je bottleneck het dagquotum is, piekurencongestie, of beide. Let op dat de betaalde opties vooral verschillen in overhead, niet in verzoekvorm: ze spreken allemaal hetzelfde OpenAI-compatibele chat-completions-formaat, dus overstappen is een wijziging van base-URL en sleutel in plaats van een herschrijving.

Een chat-frontend draaien op een directe gateway

Een directe gateway behoudt de OpenAI-compatibele verzoekvorm maar verwijdert de wachtrij van de gratis pool, omdat elk verzoek betaalde capaciteit is. APIsRouter is één voorbeeld: betaal per gebruik zonder abonnement, en een checkout op /topup zonder registratie waar je eerst betaalt en de API-sleutel per e-mail arriveert. Wereldwijde modellen draaien 20% onder de officiële prijslijst, Chinese modellen zitten onder hun officiële tarieven, en een eerste storting verdubbelt je startsaldo. De frontend-instellingen spiegelen wat je al doet met OpenRouter. In SillyTavern plak je de base-URL eindigend op /v1 (https://api.apisrouter.com/v1) en de modellenlijst vult zich automatisch vanuit /v1/models met je sleutel. De proxyconfiguratie van JanitorAI heeft in plaats daarvan het volledige endpoint nodig: https://api.apisrouter.com/v1/chat/completions, plus de modelnaam en de API-sleutel. Voor characterchat en roleplay-verkeer is de DeepSeek V4-familie de favoriet van de community qua waarde, met MiMo, GLM-5 en Kimi K2.6 als verdere waardekeuzes. Claude Sonnet 4.6 schrijft het sterkste proza voor veilig-voor-werk creatief schrijven onder Anthropics contentbeleid.

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"}]
  }'

Veelgestelde vragen