⚠️ Pending Update · 2026-08-29 Verification · Content may be outdated, please refer to official docs Updated: 2026-08-29 · Status: Pending Verification
Introduction
OpenRouter is a model-aggregation gateway — a single key unlocks 300+ models, including many free ones marked with the :free suffix. It unifies the request protocol, billing, and monitoring across providers, making it ideal for model selection, multi-provider failover, or rapid prototyping. This article walks through the full application flow and decodes the pricing rules, with a clear boundary between free-tier and paid-tier behavior.
Account Registration
- Open https://openrouter.ai/, click Sign In in the top-right, and log in with Google or GitHub.
- After login, visit https://openrouter.ai/settings/keys and click Create Key.
- Name the key (e.g.
dev-local), copy the generatedsk-or-v1-..., and store it securely — once the dialog closes you cannot view it again.
Best practice: create separate keys per use case (dev, ci, prod). OpenRouter keys do not have scoped permissions, but per-key usage is visible, so splitting keys tells you exactly which pipeline is burning quota.
Payment Method
Free models still require one-time account verification (anti-abuse):
- Visit https://openrouter.ai/settings/credits and click Add Credits.
- Top up at least $5 via card or crypto. The $5 is real money, usable on paid models.
- After top-up the account becomes "verified" —
:freemodels no longer return 429.
Note: even if you only intend to use
:freemodels, the account must be verified once. This is OpenRouter's hard rule against bot abuse — there is no bypass.
Pricing Cheat Sheet
OpenRouter billing has three layers:
:freemodels: zero cost, but rate-limited to 50–200 requests per day per model (returning 429 when exceeded).- Paid usage-based models: billed per token, from $0.1/M to $5/M. Llama 3.3 70B is about $0.6/M; GPT-4o-class runs around $5/M.
- Per-call models (a minority): billed per request, not per token. The docs mark these explicitly.
The gap between :free and paid is not just price — it is also queueing priority. :free may slow down or return 503 at peak; paid is stable. For production, treat free models as the primary route and paid as fallback.
Test the Key
curl https://openrouter.ai/api/v1/chat/completions \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek/deepseek-chat:free",
"messages":[{"role":"user","content":"ping"}]
}'
A 200 with a JSON body means the key is good. 401 = key typo. 402 = account not verified (top up).
Quota Monitoring
OpenRouter's dashboard shows daily request count and token spend. To monitor programmatically:
curl https://openrouter.ai/api/v1/key \
-H "Authorization: Bearer $OPENROUTER_API_KEY"
The JSON contains usage, limit, and limit_remaining. Pipe these into Prometheus or your log stack, alert when remaining drops below 70%.
Production Tips
- Per-client key isolation: one key per client or environment; revoking one does not break the others.
- Free-first with paid fallback: set
:freeas the primary route and a paid key as fallback. If a free tier tightens, routing degrades gracefully. - Watchdog: poll
/api/v1/keyevery 5 min forlimit_remaining; switch to the backup key when it crosses the threshold. - Audit-grade logs: record model, prompt tokens, completion tokens for every call — makes reconciliation painless.
With this flow you have a multi-provider entry that scales from free tier to production — the bill starts at zero and can upgrade on demand.
🚀 Get Started: One-Click Free API Access
Want to call all the free models above with a single API key, no need to sign up for each provider? Apishare.cc provides a unified API Key — one key, 100+ models, free models at zero cost.
👉 Register on Apishare.cc → Get your unified API Key
📊 Want to see more free model rankings? Check out the Sep 2026 Free LLM API Rankings →
Get Started: APIShare Free API Directory
- 🆓 Claim your free credits:Register on APIShare · Sign in to console
- 🔍 Browse every free API and live ranking:APIShare Free API Directory
- 📊 See the leaderboard:Free LLM API Rankings
About the Free API Aggregator
The models covered in this guide are all served through the APIShare free API aggregator, which gives you one key for the whole catalog.
- Full model catalog: APIShare free API directory
- Sign up for a free trial key: Register and claim your API key