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

Add NavyAI provider support

Tashfeen406abd8f55cd
diff --git a/README.md b/README.md
index b381bc22..c15d90aa 100644
--- a/README.md
+++ b/README.md
@@ -85,10 +85,15 @@ And the free-tier landscape shifts weekly: providers launch models, retire them,
<td align="center"><a href="https://router.bynara.id"><b>NaraRouter</b><br/>Mistral Large · Mistral Medium · Tencent Hy3</a></td>
<td align="center"><a href="https://aihorde.net"><b>AI Horde</b><br/>Community Llama · Gemma · Cydonia (anon ok, slow)</a></td>
<td align="center"><a href="https://aionlabs.ai"><b>Aion Labs</b><br/>Aggregator free tier (key, no card)</a></td>
+</tr>
+<tr>
<td align="center"><a href="https://requesty.ai"><b>Requesty</b><br/>Router free tier (key, no card)</a></td>
+<td align="center"><a href="https://api.navy"><b>NavyAI</b><br/>150K tokens/day free (key, no card)</a></td>
</tr>
</table>
+Thanks to <a href="https://github.com/MetaMysteries8">@MetaMysteries8</a> for suggesting the NavyAI integration in <a href="https://github.com/tashfeenahmed/freellmapi/issues/532">#532</a>.
+
Plus a **custom** provider — point chat, embedding, image, or audio models at any OpenAI-compatible endpoint (llama.cpp, LM Studio, vLLM, a local Ollama, or a remote gateway) from the Keys page.
Six more integrations — **Agnes AI, Reka, SiliconFlow, Routeway, BazaarLink, and AINative** — ship their models through the [live catalog](#premium-live-catalog): Premium routers serve them the day they land, free installs get them through the standard 30-day gate.
diff --git a/client/src/components/keys/shared.tsx b/client/src/components/keys/shared.tsx
index 9cbab117..784eb53a 100644
--- a/client/src/components/keys/shared.tsx
+++ b/client/src/components/keys/shared.tsx
@@ -51,6 +51,7 @@ export const PLATFORMS: { value: Platform; label: string; url: string; keyless?:
{ value: 'ainative', label: 'AINative Studio (free key)', url: 'https://ainative.studio' },
{ value: 'aion', label: 'Aion Labs (free key)', url: 'https://www.aionlabs.ai' },
{ value: 'requesty', label: 'Requesty (free key)', url: 'https://www.requesty.ai' },
+ { value: 'navy', label: 'NavyAI (free key)', url: 'https://api.navy' },
{ value: 'nara', label: 'NaraRouter (free key)', url: 'https://router.bynara.id' },
{ value: 'aihorde', label: 'AI Horde (no key needed, slow)', url: 'https://aihorde.net/register', keyless: true },
]
diff --git a/client/src/lib/routing.ts b/client/src/lib/routing.ts
index c564e28b..b5c9e5cf 100644
--- a/client/src/lib/routing.ts
+++ b/client/src/lib/routing.ts
@@ -165,6 +165,7 @@ export const platformColors: Record<string, string> = {
ainative: '#22c55e',
aion: '#6366f1',
requesty: '#10b981',
+ navy: '#1d4ed8',
nara: '#2563eb',
aihorde: '#dc2626',
}
diff --git a/server/src/__tests__/lib/key-parser.test.ts b/server/src/__tests__/lib/key-parser.test.ts
index 5e6911a9..41bb2f8b 100644
--- a/server/src/__tests__/lib/key-parser.test.ts
+++ b/server/src/__tests__/lib/key-parser.test.ts
@@ -40,6 +40,7 @@ describe('key parser', () => {
expect(detectPlatform('NARAROUTER_')).toBe('nara');
expect(detectPlatform('AIONLABS_')).toBe('aion');
expect(detectPlatform('REQUESTY_')).toBe('requesty');
+ expect(detectPlatform('NAVYAI_')).toBe('navy');
expect(detectPlatform('SAMBANOVA_')).toBeNull();
});
@@ -48,6 +49,7 @@ describe('key parser', () => {
expect(AUTH_JSON_PROVIDER_MAP['bynara']).toBe('nara');
expect(AUTH_JSON_PROVIDER_MAP['aion-labs']).toBe('aion');
expect(AUTH_JSON_PROVIDER_MAP['requesty']).toBe('requesty');
+ expect(AUTH_JSON_PROVIDER_MAP['api-navy']).toBe('navy');
const result = parseAuthJson(JSON.stringify({
credential_pool: {
gemini: [{ id: '1', label: 'Gemini', auth_type: 'api_key', access_token: 'AIza-test' }],
diff --git a/server/src/__tests__/providers/openai-compat.test.ts b/server/src/__tests__/providers/openai-compat.test.ts
index 165d184d..1b2d70b4 100644
--- a/server/src/__tests__/providers/openai-compat.test.ts
+++ b/server/src/__tests__/providers/openai-compat.test.ts
@@ -386,6 +386,7 @@ describe('OpenAICompatProvider - platform instances', () => {
{ platform: 'opencode', name: 'OpenCode Zen', baseUrl: 'https://opencode.ai/zen/v1' },
{ platform: 'aion', name: 'Aion Labs', baseUrl: 'https://api.aionlabs.ai/v1' },
{ platform: 'requesty', name: 'Requesty', baseUrl: 'https://router.requesty.ai/v1' },
+ { platform: 'navy', name: 'NavyAI', baseUrl: 'https://api.navy/v1' },
{ platform: 'nara', name: 'NaraRouter', baseUrl: 'https://router.bynara.id/v1' },
] as const;
diff --git a/server/src/__tests__/routes/analytics-requests.test.ts b/server/src/__tests__/routes/analytics-requests.test.ts
index 753b69a6..1cc0e97c 100644
--- a/server/src/__tests__/routes/analytics-requests.test.ts
+++ b/server/src/__tests__/routes/analytics-requests.test.ts
@@ -28,6 +28,15 @@ function insertCall(createdAt: string, clientIp: string | null, clientUserAgent:
`).run(status, createdAt, clientIp, clientUserAgent);
}
+function recentUtcTimestamp(hour: number) {
+ const day = new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString().slice(0, 10);
+ const hh = String(hour).padStart(2, '0');
+ return {
+ sql: `${day} ${hh}:00:00`,
+ iso: `${day}T${hh}:00:00Z`,
+ };
+}
+
describe('GET /api/analytics/requests', () => {
let app: Express;
@@ -43,9 +52,9 @@ describe('GET /api/analytics/requests', () => {
});
it('returns one row per call, newest first, with caller identity', async () => {
- insertCall('2026-07-06 10:00:00', '192.168.0.3', 'curl/8.6.0');
- insertCall('2026-07-06 11:00:00', '192.168.0.15', 'python-httpx/0.27');
- insertCall('2026-07-06 12:00:00', null, null);
+ insertCall(recentUtcTimestamp(10).sql, '192.168.0.3', 'curl/8.6.0');
+ insertCall(recentUtcTimestamp(11).sql, '192.168.0.15', 'python-httpx/0.27');
+ insertCall(recentUtcTimestamp(12).sql, null, null);
const { status, body } = await request(app, '/api/analytics/requests?range=7d');
expect(status).toBe(200);
@@ -62,16 +71,16 @@ describe('GET /api/analytics/requests', () => {
clientUserAgent: 'python-httpx/0.27',
});
// created_at is emitted as ISO-8601 UTC so the dashboard localizes it.
- expect(body.rows[1].createdAt).toBe('2026-07-06T11:00:00Z');
+ expect(body.rows[1].createdAt).toBe(recentUtcTimestamp(11).iso);
});
it('paginates with limit/offset and clamps limit to 500', async () => {
- for (let i = 0; i < 5; i++) insertCall(`2026-07-06 0${i}:00:00`, '10.0.0.1', 'ua');
+ for (let i = 0; i < 5; i++) insertCall(recentUtcTimestamp(i).sql, '10.0.0.1', 'ua');
const page = await request(app, '/api/analytics/requests?range=7d&limit=2&offset=2');
expect(page.body.total).toBe(5);
expect(page.body.rows).toHaveLength(2);
- expect(page.body.rows[0].createdAt).toBe('2026-07-06T02:00:00Z');
+ expect(page.body.rows[0].createdAt).toBe(recentUtcTimestamp(2).iso);
const clamped = await request(app, '/api/analytics/requests?range=7d&limit=99999');
expect(clamped.body.rows).toHaveLength(5);
diff --git a/server/src/__tests__/routes/proxy-stream-integrity.test.ts b/server/src/__tests__/routes/proxy-stream-integrity.test.ts
index f2def7bd..3aee04e5 100644
--- a/server/src/__tests__/routes/proxy-stream-integrity.test.ts
+++ b/server/src/__tests__/routes/proxy-stream-integrity.test.ts
@@ -54,7 +54,7 @@ function mockUpstream(script: Array<{ body: string; status?: number }>) {
const urlStr = typeof url === 'string' ? url : url.toString();
// Only intercept provider upstreams; the test's own localhost request
// and anything else goes through.
- if (!/api\.groq\.com|openrouter\.ai|api\.cohere|generativelanguage|integrate\.api\.nvidia|api\.cerebras|api\.mistral|router\.huggingface|api\.cloudflare|models\.github|open\.bigmodel|api\.llm7|api\.kilo|text\.pollinations|ollama\.com|opencode\.ai|api\.aionlabs\.ai|router\.requesty\.ai|router\.bynara\.id/.test(urlStr)) {
+ if (!/api\.groq\.com|openrouter\.ai|api\.cohere|generativelanguage|integrate\.api\.nvidia|api\.cerebras|api\.mistral|router\.huggingface|api\.cloudflare|models\.github|open\.bigmodel|api\.llm7|api\.kilo|text\.pollinations|ollama\.com|opencode\.ai|api\.aionlabs\.ai|router\.requesty\.ai|api\.navy|router\.bynara\.id/.test(urlStr)) {
return origFetch(url as any, init);
}
const reqBody = JSON.parse(String((init as RequestInit).body));
diff --git a/server/src/lib/key-parser.ts b/server/src/lib/key-parser.ts
index 4806cf7b..c467c8fe 100644
--- a/server/src/lib/key-parser.ts
+++ b/server/src/lib/key-parser.ts
@@ -36,6 +36,9 @@ export const PREFIX_MAP: Record<string, string> = {
AIONLABS_: 'aion',
AION_LABS_: 'aion',
REQUESTY_: 'requesty',
+ NAVY_: 'navy',
+ NAVYAI_: 'navy',
+ API_NAVY_: 'navy',
NARA_: 'nara',
NARAROUTER_: 'nara',
BYNARA_: 'nara',
@@ -56,6 +59,9 @@ export const AUTH_JSON_PROVIDER_MAP: Record<string, string> = {
'aion-labs': 'aion',
aionlabs: 'aion',
requesty: 'requesty',
+ navy: 'navy',
+ navyai: 'navy',
+ 'api-navy': 'navy',
nara: 'nara',
bynara: 'nara',
'nara-router': 'nara',
diff --git a/server/src/providers/index.ts b/server/src/providers/index.ts
index 80bd2a6b..a92c01e6 100644
--- a/server/src/providers/index.ts
+++ b/server/src/providers/index.ts
@@ -302,6 +302,18 @@ register(new OpenAICompatProvider({
baseUrl: 'https://router.requesty.ai/v1',
}));
+// NavyAI — OpenAI-compatible unified API (api.navy/v1). Free key from the
+// Discord-backed dashboard; the free plan is 150K tokens/day and 20 RPM.
+// Live smoke tests required an explicit User-Agent header.
+register(new OpenAICompatProvider({
+ platform: 'navy',
+ name: 'NavyAI',
+ baseUrl: 'https://api.navy/v1',
+ extraHeaders: {
+ 'User-Agent': 'FreeLLMAPI/1.0',
+ },
+}));
+
// NaraRouter — OpenAI-compatible aggregator (router.bynara.id/v1). Free plan
// requires a no-card API key plus Telegram channel/link verification. Live
// probed 2026-07-09: `mistral-large`, `mistral-medium-3-5`, and `tencent-hy3`
diff --git a/server/src/routes/keys.ts b/server/src/routes/keys.ts
index f93829b8..1decf351 100644
--- a/server/src/routes/keys.ts
+++ b/server/src/routes/keys.ts
@@ -19,7 +19,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', 'requesty', 'nara', 'aihorde', 'custom',
+ 'routeway', 'bazaarlink', 'ainative', 'aion', 'requesty', 'navy', 'nara', '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 5bce5a5e..917f9b2f 100644
--- a/server/src/services/provider-quota.ts
+++ b/server/src/services/provider-quota.ts
@@ -138,12 +138,13 @@ function inferPoolForPlatform(platform: Platform, modelId?: string | null): stri
if (platform === 'ainative') return 'ainative::account';
if (platform === 'aion') return 'aion::free';
if (platform === 'requesty') return 'requesty::free';
+ if (platform === 'navy') return 'navy::free';
if (platform === 'nara') return 'nara::free';
return normalizedModelId ? `${platform}::${normalizedModelId}` : `${platform}::account`;
}
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', 'nara', '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', '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 4742d8a4..f5fad42a 100644
--- a/shared/types.ts
+++ b/shared/types.ts
@@ -91,6 +91,9 @@ export type Platform =
// Requesty — OpenAI-compatible router with no-card free models/credits.
// Catalog rows live in the Oracle catalog (premium now, free after 30 days).
| 'requesty'
+ // NavyAI — OpenAI-compatible unified API. Free plan is 150K tokens/day and
+ // 20 RPM; catalog rows live in the Oracle catalog (premium now, free after 30 days).
+ | 'navy'
// NaraRouter — OpenAI-compatible aggregator. Free account key from
// router.bynara.id after Telegram channel/link verification; free-plan routes
// reset daily and are catalog-managed (premium now, free after 30 days).