One endpoint in front of every free LLM tier, with automatic failover and no provider key ever leaving the box. Providers are data, not code: adding one is a JSON file plus an env var, never a TypeScript change. Ships 12 providers pre-written; `verify-provider --apply` derives the live model list from your own key. - core: registry, bucketed quota meter (rolling + UTC-calendar windows), key-pool store, 6-step model router with diagnostic rejection reasons - gateway: node:http, failover that commits to a stream only after 200 headers, SSE passthrough with usage sniffing, virtual keys with admin/inference roles - context engine: sqlite sessions and a 5-rung refit ladder, so a 128k thread keeps working when it fails over to an 8k model - cache: exact (sha256, safe-by-default) + opt-in semantic (flat Float32Array) - guard: inbound limits, quota forecasting, limit calibration from upstream headers, key health, secret/PII/injection scanning - dashboard: one self-contained HTML file, live SSE request log, token usage - sdk: zero-dep typed client, drop-in for the OpenAI SDK Zero runtime dependencies. 326 tests, 27-check smoke suite against a scripted mock upstream so routing is testable without spending quota. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
21 lines
976 B
JSON
21 lines
976 B
JSON
{
|
|
"$schema": "./_schema.json",
|
|
"id": "openrouter",
|
|
"label": "OpenRouter (free models)",
|
|
"docs": "https://openrouter.ai/docs",
|
|
"console": "https://openrouter.ai/keys",
|
|
"priority": 40,
|
|
"baseUrl": "https://openrouter.ai/api/v1",
|
|
"auth": { "type": "bearer", "envKeys": ["OPENROUTER_API_KEY"] },
|
|
"limits": { "rpm": 20, "rpd": 50 },
|
|
"limitsSource": "unverified",
|
|
"verifiedOn": "2026-08-16",
|
|
"modelsEndpoint": "/models",
|
|
"modelsPath": "data[].id",
|
|
"headers": { "HTTP-Referer": "https://github.com/freeway", "X-Title": "Freeway" },
|
|
"notes": "Only :free-suffixed models cost nothing. Free daily request caps depend on account credit history, so limits here are unverified on purpose. Model ids contain a slash (vendor/model), which the first-slash pin rule handles.",
|
|
"models": [
|
|
{ "id": "meta-llama/llama-3.3-70b-instruct:free", "label": "Llama 3.3 70B (free)", "alias": ["big"], "context": 65536, "caps": ["chat", "tools"], "priority": 10 }
|
|
]
|
|
}
|