Skip to content

7.4 billion tokens per month. 34 free LLM providers. 635 free model endpoints. All behind one /v1 endpoint, plus any custom OpenAI-compatible endpoint. Smart routing, automatic failover, encrypted keys. Personal experimentation only.

TypeScript

feat(providers): add OrcaRouter (free rate-limited aliases) (#896)

Tashfeenfba4b3dbab91
diff --git a/client/src/components/keys/shared.tsx b/client/src/components/keys/shared.tsx
index f0eb4f4d..83287d8a 100644
--- a/client/src/components/keys/shared.tsx
+++ b/client/src/components/keys/shared.tsx
@@ -54,6 +54,7 @@ export const PLATFORMS: { value: Platform; label: string; url: string; keyless?:
{ value: 'navy', label: 'NavyAI (free key)', url: 'https://api.navy' },
{ value: 'nara', label: 'NaraRouter (free key)', url: 'https://router.bynara.id' },
{ value: 'sealion', label: 'SEA-LION (free key)', url: 'https://sea-lion.ai' },
+ { value: 'orcarouter', label: 'OrcaRouter (free key)', url: 'https://www.orcarouter.ai' },
// AnyAPI advertises 100K tokens/day free, but live testing on 2026-08-10
// could not get a single free-tier request served (see
// CATALOG-ANYAPI-SMOKE-2026-08-10 in the ops repo). No quota claim until
diff --git a/client/src/lib/routing.ts b/client/src/lib/routing.ts
index a09e2d37..48db90c9 100644
--- a/client/src/lib/routing.ts
+++ b/client/src/lib/routing.ts
@@ -304,6 +304,7 @@ export const platformColors: Record<string, string> = {
navy: '#1d4ed8',
nara: '#2563eb',
sealion: '#0ea5e9',
+ orcarouter: '#f97316',
anyapi: '#0891b2',
modelscope: '#624aff',
aihorde: '#dc2626',
diff --git a/server/src/__tests__/lib/key-parser.test.ts b/server/src/__tests__/lib/key-parser.test.ts
index 25698471..e42e539d 100644
--- a/server/src/__tests__/lib/key-parser.test.ts
+++ b/server/src/__tests__/lib/key-parser.test.ts
@@ -55,6 +55,8 @@ describe('key parser', () => {
expect(detectPlatform('REQUESTY_')).toBe('requesty');
expect(detectPlatform('NAVYAI_')).toBe('navy');
expect(detectPlatform('SEALION_')).toBe('sealion');
+ expect(detectPlatform('ORCAROUTER_')).toBe('orcarouter');
+ expect(detectPlatform('ORCA_')).toBe('orcarouter');
expect(detectPlatform('MODELSCOPE_')).toBe('modelscope');
expect(detectPlatform('ANYAPI_')).toBe('anyapi');
expect(detectPlatform('ANY_API_')).toBe('anyapi');
@@ -68,6 +70,7 @@ describe('key parser', () => {
expect(AUTH_JSON_PROVIDER_MAP['requesty']).toBe('requesty');
expect(AUTH_JSON_PROVIDER_MAP['api-navy']).toBe('navy');
expect(AUTH_JSON_PROVIDER_MAP['sea-lion']).toBe('sealion');
+ expect(AUTH_JSON_PROVIDER_MAP['orca-router']).toBe('orcarouter');
expect(AUTH_JSON_PROVIDER_MAP['model-scope']).toBe('modelscope');
expect(AUTH_JSON_PROVIDER_MAP['any-api']).toBe('anyapi');
const result = parseAuthJson(JSON.stringify({
diff --git a/server/src/__tests__/providers/openai-compat.test.ts b/server/src/__tests__/providers/openai-compat.test.ts
index 0a2d3cf1..7c31810b 100644
--- a/server/src/__tests__/providers/openai-compat.test.ts
+++ b/server/src/__tests__/providers/openai-compat.test.ts
@@ -514,6 +514,7 @@ describe('OpenAICompatProvider - platform instances', () => {
{ platform: 'navy', name: 'NavyAI', baseUrl: 'https://api.navy/v1' },
{ platform: 'nara', name: 'NaraRouter', baseUrl: 'https://router.bynara.id/v1' },
{ platform: 'sealion', name: 'SEA-LION', baseUrl: 'https://api.sea-lion.ai/v1' },
+ { platform: 'orcarouter', name: 'OrcaRouter', baseUrl: 'https://api.orcarouter.ai/v1' },
// modelscope registers a ModelScopeProvider subclass (custom validateKey,
// see providers/modelscope.test.ts) but chat routing is stock openai-compat.
{ platform: 'modelscope', name: 'ModelScope', baseUrl: 'https://api-inference.modelscope.cn/v1' },
diff --git a/server/src/lib/key-parser.ts b/server/src/lib/key-parser.ts
index 45522c65..9906843c 100644
--- a/server/src/lib/key-parser.ts
+++ b/server/src/lib/key-parser.ts
@@ -72,6 +72,9 @@ export const PREFIX_MAP: Record<string, string> = {
BYNARA_: 'nara',
SEALION_: 'sealion',
SEA_LION_: 'sealion',
+ ORCAROUTER_: 'orcarouter',
+ ORCA_ROUTER_: 'orcarouter',
+ ORCA_: 'orcarouter',
MODELSCOPE_: 'modelscope',
MODEL_SCOPE_: 'modelscope',
ANYAPI_: 'anyapi',
@@ -101,6 +104,9 @@ export const AUTH_JSON_PROVIDER_MAP: Record<string, string> = {
'nara-router': 'nara',
sealion: 'sealion',
'sea-lion': 'sealion',
+ orcarouter: 'orcarouter',
+ 'orca-router': 'orcarouter',
+ orca: 'orcarouter',
modelscope: 'modelscope',
'model-scope': 'modelscope',
anyapi: 'anyapi',
diff --git a/server/src/providers/index.ts b/server/src/providers/index.ts
index 082580bc..0442c61f 100644
--- a/server/src/providers/index.ts
+++ b/server/src/providers/index.ts
@@ -354,6 +354,19 @@ register(new OpenAICompatProvider({
baseUrl: 'https://api.sea-lion.ai/v1',
}));
+// OrcaRouter — OpenAI-compatible aggregator (api.orcarouter.ai/v1). Free key
+// from orcarouter.ai (no card, `sk-orca-` prefix). Recurring rate-limited free
+// aliases at $0 (`*-free` ids plus the `orcarouter/free` auto route); limits
+// are intentionally unpublished (429 on cap) and free routes never fall back
+// to paid models, so a 429 is a clean quota signal, not a wallet risk.
+// Live-verified 2026-08-15. Catalog rows live in the Oracle catalog (premium
+// now, free after the 30-day model-age gate).
+register(new OpenAICompatProvider({
+ platform: 'orcarouter',
+ name: 'OrcaRouter',
+ baseUrl: 'https://api.orcarouter.ai/v1',
+}));
+
// ModelScope (魔搭社区, Alibaba) — OpenAI-compatible inference API
// (api-inference.modelscope.cn/v1, Bearer auth). Free tier: 2000 requests/day
// account-wide. Token from modelscope.cn/my/myaccesstoken, BUT calls only work
diff --git a/server/src/routes/keys.ts b/server/src/routes/keys.ts
index a4a338a5..6c17ae64 100644
--- a/server/src/routes/keys.ts
+++ b/server/src/routes/keys.ts
@@ -31,7 +31,7 @@ const PLATFORMS = [
'google', 'groq', 'cerebras', 'nvidia', 'mistral',
'openrouter', 'github', 'cohere', 'cloudflare', 'zhipu', 'ollama',
'kilo', 'pollinations', 'llm7', 'huggingface', 'opencode', 'ovh', 'agnes', 'reka', 'siliconflow',
- 'routeway', 'bazaarlink', 'ainative', 'aion', 'anyapi', 'requesty', 'navy', 'nara', 'sealion', 'modelscope', 'aihorde', 'custom',
+ 'routeway', 'bazaarlink', 'ainative', 'aion', 'anyapi', 'requesty', 'navy', 'nara', 'sealion', 'orcarouter', 'modelscope', 'aihorde', 'custom',
] as const;
const ALLOWED_IMPORT_EXTENSIONS = new Set(['.env', '.json', '.jsonc', '.md', '.txt', '.csv']);
diff --git a/server/src/services/provider-quota.ts b/server/src/services/provider-quota.ts
index 5f6b1c72..1ce508d9 100644
--- a/server/src/services/provider-quota.ts
+++ b/server/src/services/provider-quota.ts
@@ -141,6 +141,9 @@ function inferPoolForPlatform(platform: Platform, modelId?: string | null): stri
if (platform === 'navy') return 'navy::free';
if (platform === 'nara') return 'nara::free';
if (platform === 'sealion') return 'sealion::free';
+ // OrcaRouter: one rate-limited free allowance across all `*-free` aliases
+ // and the `orcarouter/free` auto route (limits unpublished; 429 on cap).
+ if (platform === 'orcarouter') return 'orcarouter::free';
// AnyAPI: the free tier is one 100K-tokens/day budget for the whole account,
// shared across every free/basic model — so one pool, not one per model.
if (platform === 'anyapi') return 'anyapi::free';
@@ -150,7 +153,7 @@ function inferPoolForPlatform(platform: Platform, modelId?: string | null): stri
}
function isSharedPool(platform: Platform): boolean {
- return ['openrouter', 'google', 'groq', 'cerebras', 'sambanova', 'nvidia', 'mistral', 'github', 'cohere', 'cloudflare', 'zhipu', 'ollama', 'kilo', 'pollinations', 'llm7', 'huggingface', 'opencode', 'routeway', 'bazaarlink', 'ainative', 'aion', 'requesty', 'navy', 'nara', 'sealion', 'anyapi', 'modelscope', 'aihorde'].includes(platform);
+ return ['openrouter', 'google', 'groq', 'cerebras', 'sambanova', 'nvidia', 'mistral', 'github', 'cohere', 'cloudflare', 'zhipu', 'ollama', 'kilo', 'pollinations', 'llm7', 'huggingface', 'opencode', 'routeway', 'bazaarlink', 'ainative', 'aion', 'requesty', 'navy', 'nara', 'sealion', 'orcarouter', 'anyapi', 'modelscope', 'aihorde'].includes(platform);
}
type HeaderSpec = { metric: QuotaMetric; limit: string; remaining?: string; reset?: string; strategy?: QuotaResetStrategy };
diff --git a/shared/types.ts b/shared/types.ts
index 06384c4d..446d0e8b 100644
--- a/shared/types.ts
+++ b/shared/types.ts
@@ -124,6 +124,11 @@ export type Platform =
// (Google sign-in, no card, no region wall) at 10 RPM; catalog rows live in
// the Oracle catalog (premium now, free after 30 days).
| 'sealion'
+ // OrcaRouter — OpenAI-compatible aggregator (api.orcarouter.ai/v1). Free key
+ // from orcarouter.ai (no card); recurring rate-limited free aliases at $0
+ // (never fall back to paid). Catalog rows live in the Oracle catalog
+ // (premium now, free after the 30-day model-age gate).
+ | 'orcarouter'
// ModelScope (魔搭社区, Alibaba) — OpenAI-compatible inference API
// (api-inference.modelscope.cn/v1). Free tier is 2000 requests/day
// account-wide, but calls only work after the ModelScope account is bound to