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
fix(providers): send a User-Agent to Septor Labs and CLōD, treat a Cloudflare challenge as inconclusive (#1298) (#1301)
Tashfeenfa1200833ad7
diff --git a/server/src/__tests__/providers/clod-speechify-blaze.test.ts b/server/src/__tests__/providers/clod-speechify-blaze.test.tsindex 408b9db3..953a1c8a 100644--- a/server/src/__tests__/providers/clod-speechify-blaze.test.ts+++ b/server/src/__tests__/providers/clod-speechify-blaze.test.ts@@ -23,6 +23,10 @@ describe('CLōD, Speechify and BlazeAPI adapters', () => {expect(fetch.mock.calls[0][0]).toBe(endpoint);expect(fetch.mock.calls[0][1]?.method).toBe('GET');expect(new Headers(fetch.mock.calls[0][1]?.headers).get('Authorization')).toBe('Bearer test-key');+ if (platform === 'clod') {+ // Cloudflare challenges Node's default UA from datacenter IPs (#1298).+ expect(new Headers(fetch.mock.calls[0][1]?.headers).get('user-agent')).toBe('FreeLLMAPI/1.0');+ }fetch.mockResolvedValue(json({ error: 'Invalid key' }, 401));await expect(getProvider(platform)!.validateKey('test-key')).resolves.toMatchObject({ valid: false });fetch.mockResolvedValue(json({ error: 'Unavailable' }, 503));diff --git a/server/src/__tests__/providers/router9-septor.test.ts b/server/src/__tests__/providers/router9-septor.test.tsindex c388f749..40c04c4e 100644--- a/server/src/__tests__/providers/router9-septor.test.ts+++ b/server/src/__tests__/providers/router9-septor.test.ts@@ -85,6 +85,8 @@ describe('Router9 and Septor adapters', () => {await expect(getProvider('septor')!.validateKey('test-key')).resolves.toBe(true);expect(fetch.mock.calls[0][0]).toBe('https://api.septorlabs.com/v1/models');expect(fetch.mock.calls[0][1]?.method).toBe('GET');+ // Cloudflare challenges Node's default UA from datacenter IPs (#1298).+ expect(new Headers(fetch.mock.calls[0][1]?.headers).get('user-agent')).toBe('FreeLLMAPI/1.0');});it.each([401, 403])('Septor rejects invalid credentials (%s)', async status => {@@ -92,6 +94,13 @@ describe('Router9 and Septor adapters', () => {await expect(getProvider('septor')!.validateKey('bad-test-key')).resolves.toMatchObject({ valid: false });});+ it('Septor treats a Cloudflare challenge page as inconclusive, not a bad key', async () => {+ vi.spyOn(global, 'fetch').mockResolvedValue(new Response('<!DOCTYPE html><title>Just a moment...</title>', {+ status: 403, headers: { 'Content-Type': 'text/html', 'cf-mitigated': 'challenge' },+ }));+ await expect(getProvider('septor')!.validateKey('test-key')).rejects.toThrow('Cloudflare challenge');+ });+it('Router9 reuses inline-reasoning normalization for non-streaming answers', async () => {vi.spyOn(global, 'fetch').mockResolvedValue(json(completion('MiniMax-M3', '<think>19 + 23 = 42.</think>\n\n42')));const result = await getProvider('router9')!.chatCompletion('test-key', [], 'minimax/minimax-m3');diff --git a/server/src/providers/base.ts b/server/src/providers/base.tsindex cb7118a7..63a6a043 100644--- a/server/src/providers/base.ts+++ b/server/src/providers/base.ts@@ -249,6 +249,12 @@ export abstract class BaseProvider {*/protected async validationResult(res: Response): Promise<KeyValidationResult> {if (res.status !== 401 && res.status !== 403) return true;+ // A Cloudflare bot challenge ("Just a moment...") is a 403 about the+ // caller's IP and User-Agent, not about the key. Surface it as+ // inconclusive so health never auto-disables a good key behind it (#1298).+ if (res.headers?.get('cf-mitigated') === 'challenge') {+ throw providerHttpError(res, `${this.name} key validation blocked by a Cloudflare challenge (HTTP ${res.status}); the key was not checked`);+ }let body: any = null;try {diff --git a/server/src/providers/clod.ts b/server/src/providers/clod.tsindex d54948c2..d818a9e9 100644--- a/server/src/providers/clod.ts+++ b/server/src/providers/clod.ts@@ -22,7 +22,12 @@ export class ClodProvider extends OpenAICompatProvider {}constructor() {- super({ platform: 'clod', name: 'CLōD', baseUrl: 'https://api.clod.io/v1' });+ // Same Cloudflare challenge as Septor for tool User-Agents from datacenter+ // IPs (#1298); a product UA gets the real 401/200 answer.+ super({+ platform: 'clod', name: 'CLōD', baseUrl: 'https://api.clod.io/v1',+ extraHeaders: { 'User-Agent': 'FreeLLMAPI/1.0' },+ });}override async chatCompletion(diff --git a/server/src/providers/septor.ts b/server/src/providers/septor.tsindex 11e7abce..6457d210 100644--- a/server/src/providers/septor.ts+++ b/server/src/providers/septor.ts@@ -16,7 +16,13 @@ function checkModel(requested: string, returned: string): void {export class SeptorProvider extends OpenAICompatProvider {constructor() {// /models rejects missing and invalid credentials (401), unlike Router9.- super({ platform: 'septor', name: 'Septor Labs', baseUrl: 'https://api.septorlabs.com/v1' });+ // Cloudflare in front challenges tool User-Agents (Node's default "node",+ // curl) from datacenter IPs with a 403 HTML page, which read as a bad key+ // on self-hosted VPS installs (#1298). A product UA passes.+ super({+ platform: 'septor', name: 'Septor Labs', baseUrl: 'https://api.septorlabs.com/v1',+ extraHeaders: { 'User-Agent': 'FreeLLMAPI/1.0' },+ });}override async chatCompletion(