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

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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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(