@@ -1307,7 +1307,7 @@ Métricas canônicas em 2026-08-24: **1.029 vídeos únicos** · **11.132.922 vi
Resilience Guide Circuit breakers, cooldowns, queue, anti-thundering herd, TLS spoofing Auto-Combo Engine 16-factor scoring, mode packs, self-healing Proxy Guide 3-level proxy system, 1proxy marketplace, registry CRUD
-
Free Tiers Consolidated directory: 34 documented recurring pools / 442 cataloged free-tier entries
+
Free Tiers Consolidated directory: 34 documented recurring pools / 444 cataloged free-tier entries Features Gallery Visual dashboard tour with screenshots Codebase Documentation Beginner-friendly codebase walkthrough
diff --git a/docs/diagrams/free-tier-budget.svg b/docs/diagrams/free-tier-budget.svg
index 19e0ca5f16b..f706e4824f5 100644
--- a/docs/diagrams/free-tier-budget.svg
+++ b/docs/diagrams/free-tier-budget.svg
@@ -1,4 +1,4 @@
-
+
Pool-deduplicated chart of the 16 recurring free-token pools with positive published budgets (plus Groq's five per-model caps as one segment), plus signup credits and uncapped providers shown separately.
@@ -64,7 +64,7 @@
~1.47B
FREE TOKENS / MONTH · STEADY
up to ~2.10B in your first month — signup credits
- documented free tiers · 34 recurring pools · 442 catalog entries · one endpoint
+ documented free tiers · 34 recurring pools · 444 catalog entries · one endpoint
por ` (the figure is only visible inside an account console; the comment records who saw it and when, and the public page that says the cap exists). The state today: the five blocks re-audited on 2026-09-02 carry it (`gemini`, `groq`, `mistral`, `ollama-cloud`, `nara`); entries that predate the 2026-09-02 re-audit inherit the earlier research until they are touched; any **new or changed** number without an evidence comment is a bug. Today only `mistral` is console-verified.
---
+## Why our number is smaller than other aggregators'
+
+Most "free tokens per month" figures in this space are sums of per-model labels. Ours is not, on purpose:
+
+- **Each shared pool is counted once.** Mistral's free plan is one 1B/month allowance per organization; listing it under five models does not make it 5B. Summed per model, our own catalog would read **~7.4B** (recomputed on 2026-09-03; this figure is not CI-gated — re-measure it whenever the catalog changes) — the headline says **~1.47B** because that is what one account of each provider can actually spend.
+- **Daily caps are converted, rates are not.** A documented tokens/day cap becomes `× 30`; a documented requests/day cap becomes `RPD × ~800 tokens × 30`; a provider that only publishes requests-per-minute has **no** monthly figure and is listed as _uncapped_, never summed. Multiplying a rate limit by 24/7 is the inflation we refuse.
+- **Quotas behind a regional identity check are shown apart** (`+~6M behind regional identity verification`), because most readers cannot use them.
+- **Signup credits are first-month only** and reported as a second figure, never blended into the steady number.
+- **The figure is enforced by CI.** `npm run check:docs-counts` recomputes the totals from the catalog and fails the build when this file, the README or the budget card drift from them.
+
+---
+
## ToS attention table
> **ToS flag is advisory, not a routing gate.** Providers marked `tos` are still included in routing and combo/fallback by default; the flag only surfaces on `/dashboard/free-tiers` and `/api/free-tier/summary`. The `excludeTosAvoid` query parameter affects the summary view only, not global routing. The verdict lives in `open-sse/config/freeTierCatalog.ts` (informational, not read by routing engines).
diff --git a/docs/screenshots/free-tier-budget-card.svg b/docs/screenshots/free-tier-budget-card.svg
index 90ab6b02794..15e11774a90 100644
--- a/docs/screenshots/free-tier-budget-card.svg
+++ b/docs/screenshots/free-tier-budget-card.svg
@@ -1,94 +1,104 @@
-
-OmniRoute · /dashboard/free-tiers · preview mockup
+
+OmniRoute · /dashboard/free-tiers · preview mockup
Monthly free-token budget
-20 free pools · 446 models · one endpoint
+21 free pools · 444 models · one endpoint
Steady / month
-~1.48B
+~1.47B
First month (+ signup credits)
~2.10B
ToS-flagged (you decide)
13 providers
Each segment = one free pool · widths floored so every provider shows · honest numbers in the grid.
Mistral Large 3 1.00B
GPT-4o mini 150M
+Agnes 2.0 Flash 210M
Tencent Hy3 150M
+GPT-4o mini 150M
Gemini 2.5 Flash 60M
+Llama 3.3 70B 30M
Llama 3.3 70B 30M
+Grok-3 24M
Grok-3 24M
+GPT-4o 7M
DeepSeek V4 Pro 20M
+GPT-OSS 120B 6M
GPT-4o 7M
+GPT-OSS 20B 6M
MiniMax-M2.7 6M
+GPT-OSS Safeguard 20B 6M
Arcee Trinity Large Prev 5M
+Qwen3.6 27B 6M
NavyAI free pool 5M
+Qwen3.8 27B 6M
Auto Free 4M
+MiniMax-M2.7 6M
Auto 1M
+Arcee Trinity Large Prev 5M
Command A Reasoning 800K
+NavyAI free pool 5M
ERNIE 4.5 VL 424B A47B B 500K
+Auto Free 4M
morph-v3-large 400K
+Auto 1M
Llama 3.1 8B 200K
+Command A Reasoning 800K
Claude Sonnet 4.5 25K
-+ First month: one-time signup credits (~626M)
-vertex 300M
-agentrouter 200M
-predibase 25M
-together 25M
-glm-cn 20M
-doubao 15M
-ai21 10M
-longcat 10M
+ERNIE 4.5 VL 424B A47B B 500K
+morph-v3-large 400K
+Llama 3.1 8B 200K
+Claude Sonnet 4.5 25K
++ First month: one-time signup credits (~626M)
deepseek 5M
-Pool-deduped, honest counting — no inflated rate-limit ceilings. Some terms suggest personal-use only; we flag them so you decide.
-+ 12 permanently-free, no-cap providers (e.g. baidu, glm-cn, opencode-zen) · OpenRouter $10 → +24M/mo.
+vertex 300M
+agentrouter 200M
+predibase 25M
+together 25M
+glm-cn 20M
+doubao 15M
+ai21 10M
+longcat 10M
+deepseek 5M
+Pool-deduped, honest counting — no inflated rate-limit ceilings. Some terms suggest personal-use only; we flag them so you decide.
++ 15 permanently-free, no-cap providers (e.g. agnes, ainative, aion) · OpenRouter $10 → +24M/mo.
++ ~6M behind regional identity verification (modelscope) — real quota, never in the headline.
diff --git a/open-sse/config/freeModelCatalog.data.ts b/open-sse/config/freeModelCatalog.data.ts
index 08b54e455df..c6b8b133a34 100644
--- a/open-sse/config/freeModelCatalog.data.ts
+++ b/open-sse/config/freeModelCatalog.data.ts
@@ -287,6 +287,14 @@ export const FREE_MODEL_BUDGETS: FreeModelBudget[] = [
{ provider: "mistral", modelId: "mistral-small-latest", displayName: "Mistral Small 4", monthlyTokens: 1000000000, creditTokens: 0, freeType: "recurring-monthly", poolKey: "mistral", tos: "caution" },
{ provider: "mistral", modelId: "devstral-latest", displayName: "Devstral 2", monthlyTokens: 1000000000, creditTokens: 0, freeType: "recurring-monthly", poolKey: "mistral", tos: "caution" },
{ provider: "mistral", modelId: "codestral-latest", displayName: "Codestral", monthlyTokens: 1000000000, creditTokens: 0, freeType: "recurring-monthly", poolKey: "mistral", tos: "caution" },
+ // evidence: public-page https://modelscope.cn/docs/model-service/API-Inference/limits and
+ // https://modelscope.cn/docs/magicube/intro (2026-09-02) — API-Inference is free; calls are paid with
+ // 魔粒: "注册并登录 200 魔粒/日" + "绑定阿里云账号 50 魔粒/日", 1 魔粒 per call on "主流" models ⇒ ~250 calls/day
+ // ⇒ 250 × 800 × 30 = 6M/month, one balance per account (single pool).
+ // eligibilityGate: "账号注册后需绑定阿里云账号，并且通过实名认证后才可使用" (Alibaba Cloud binding + mainland
+ // real-name verification). The docs also call the product "非商业化，非盈利" — hence tos: caution.
+ { provider: "modelscope", modelId: "Qwen/Qwen3.5-397B-A17B", displayName: "Qwen3.5 397B A17B (ModelScope)", monthlyTokens: 6000000, creditTokens: 0, freeType: "recurring-daily", poolKey: "modelscope-free", tos: "caution", eligibilityGate: "regional-identity" },
+ { provider: "modelscope", modelId: "deepseek-ai/DeepSeek-V4-Pro", displayName: "DeepSeek V4 Pro (ModelScope)", monthlyTokens: 6000000, creditTokens: 0, freeType: "recurring-daily", poolKey: "modelscope-free", tos: "caution", eligibilityGate: "regional-identity" },
{ provider: "monsterapi", modelId: "llama-3-8b-fuse", displayName: "Llama 3 8B Fuse", monthlyTokens: 0, creditTokens: 0, freeType: "one-time-initial", poolKey: "monsterapi", tos: "ambiguous" },
{ provider: "morph", modelId: "morph-v3-large", displayName: "morph-v3-large", monthlyTokens: 400000, creditTokens: 0, freeType: "recurring-monthly", poolKey: "morph", tos: "ok" },
{ provider: "morph", modelId: "morph-v3-fast", displayName: "morph-v3-fast", monthlyTokens: 400000, creditTokens: 0, freeType: "recurring-monthly", poolKey: "morph", tos: "ok" },
diff --git a/open-sse/config/freeModelCatalog.ts b/open-sse/config/freeModelCatalog.ts
index 041e3934307..aa32a36464d 100644
--- a/open-sse/config/freeModelCatalog.ts
+++ b/open-sse/config/freeModelCatalog.ts
@@ -11,6 +11,13 @@ export type FreeModelFreeType =
| "keyless"
| "discontinued";
+/**
+ * A real, recurring quota that only opens after an identity check tied to a
+ * region (e.g. 实名认证 with a mainland-China ID). One member today; extend the
+ * union when a second kind of gate is catalogued.
+ */
+export type FreeEligibilityGate = "regional-identity";
+
export interface FreeModelBudget {
provider: string;
modelId: string;
@@ -40,14 +47,28 @@ export interface FreeModelBudget {
* `open-sse/services/autoCombo/strictZeroCostFilter.ts`.
*/
hardStopGuaranteed?: boolean;
+ /**
+ * Set when the quota is real and recurring but only reachable after a
+ * region-bound identity verification. Affects COUNTING only: the row
+ * leaves the steady headline and lands in `gatedRecurringTokens`.
+ * Routing, `isFreeModel` and STRICT_ZERO_COST read `freeType` alone.
+ * Put the gate's source in a comment next to the entry.
+ */
+ eligibilityGate?: FreeEligibilityGate;
}
export interface FreeModelTotals {
/** Pool-deduped recurring tokens/month — the headline "steady" number. */
steadyRecurringTokens: number;
- /** Steady + recurring credit grants (e.g. monthly $-credit plans). */
+ /**
+ * Steady + recurring credit grants (e.g. monthly $-credit plans).
+ * Eligibility-gated rows contribute nothing, exactly like the steady headline.
+ */
steadyWithRecurringCreditsTokens: number;
- /** Steady + recurring + one-time signup credits — first-month only. */
+ /**
+ * Steady + recurring + one-time signup credits — first-month only.
+ * Eligibility-gated rows contribute nothing, exactly like the steady headline.
+ */
firstMonthRealisticTokens: number;
/**
* Extra recurring tokens/month unlocked by a one-time small deposit
@@ -59,8 +80,16 @@ export interface FreeModelTotals {
* Providers that are permanently free but publish NO token cap
* (rate/concurrency-limited). Real access, but un-quantifiable — listed,
* never summed into the headline (avoids the rate-limit×24/7 inflation).
+ * Eligibility-gated rows are excluded: the list reads as "open to anyone".
*/
uncappedProviders: string[];
+ /**
+ * Pool-deduped tokens/month behind an eligibility gate (same rule as the
+ * headline). Never summed into `steadyRecurringTokens`.
+ */
+ gatedRecurringTokens: number;
+ /** Providers (sorted) contributing to `gatedRecurringTokens`. */
+ gatedProviders: string[];
modelCount: number;
poolCount: number;
perModel: FreeModelBudget[];
@@ -224,41 +253,60 @@ export function computeFreeModelTotals(
(m) => !(opts.excludeTosAvoid && m.tos === "avoid") && m.enabled !== false
);
+ const isGated = (m: FreeModelBudget) => m.eligibilityGate !== undefined;
+
const steadyRecurringTokens = dedupedSum(
models,
(m) => m.monthlyTokens,
- (m) => STEADY_MONTHLY.has(m.freeType)
+ (m) => STEADY_MONTHLY.has(m.freeType) && !isGated(m)
);
+ const gatedRecurringTokens = dedupedSum(
+ models,
+ (m) => m.monthlyTokens,
+ (m) => STEADY_MONTHLY.has(m.freeType) && isGated(m)
+ );
+ const gatedProviders = [
+ ...new Set(
+ models.filter((m) => STEADY_MONTHLY.has(m.freeType) && isGated(m)).map((m) => m.provider)
+ ),
+ ].sort();
const recurringCredits = dedupedSum(
models,
(m) => m.creditTokens,
- (m) => RECURRING_CREDIT.has(m.freeType)
+ (m) => RECURRING_CREDIT.has(m.freeType) && !isGated(m)
);
const oneTimeCredits = dedupedSum(
models,
(m) => m.creditTokens,
- (m) => ONE_TIME_CREDIT.has(m.freeType)
+ (m) => ONE_TIME_CREDIT.has(m.freeType) && !isGated(m)
);
const steadyWithRecurringCreditsTokens = steadyRecurringTokens + recurringCredits;
const firstMonthRealisticTokens = steadyWithRecurringCreditsTokens + oneTimeCredits;
const poolCount = new Set(
- models.filter((m) => STEADY_MONTHLY.has(m.freeType) && m.poolKey).map((m) => m.poolKey)
+ models
+ .filter((m) => STEADY_MONTHLY.has(m.freeType) && m.poolKey && !isGated(m))
+ .map((m) => m.poolKey)
).size;
// Deposit-unlock boost: sum the FREE_TIER_BOOSTS whose pool still has a live
// recurring model in the (optionally ToS-filtered) set.
const livePools = new Set(
- models.filter((m) => STEADY_MONTHLY.has(m.freeType) && m.poolKey).map((m) => m.poolKey)
+ models
+ .filter((m) => STEADY_MONTHLY.has(m.freeType) && m.poolKey && !isGated(m))
+ .map((m) => m.poolKey)
);
const boostMonthlyTokens = Object.entries(FREE_TIER_BOOSTS)
.filter(([pool]) => livePools.has(pool))
.reduce((s, [, b]) => s + b.boostMonthlyTokens, 0);
// Permanently-free-but-uncapped providers (real access, no published cap).
+ // Gated rows are excluded: the list is read as "anyone can use this, forever".
const uncappedProviders = [
- ...new Set(models.filter((m) => UNCAPPED.has(m.freeType)).map((m) => m.provider)),
+ ...new Set(
+ models.filter((m) => UNCAPPED.has(m.freeType) && !isGated(m)).map((m) => m.provider)
+ ),
].sort();
return {
@@ -267,6 +315,8 @@ export function computeFreeModelTotals(
firstMonthRealisticTokens,
boostMonthlyTokens,
uncappedProviders,
+ gatedRecurringTokens,
+ gatedProviders,
modelCount: models.length,
poolCount,
perModel: models.slice().sort((a, b) => b.monthlyTokens - a.monthlyTokens),
diff --git a/scripts/check/check-docs-counts-sync.mjs b/scripts/check/check-docs-counts-sync.mjs
index 29a42fca2a1..4e74d304647 100644
--- a/scripts/check/check-docs-counts-sync.mjs
+++ b/scripts/check/check-docs-counts-sync.mjs
@@ -218,12 +218,16 @@ function readCodeFacts() {
"const t=computeFreeModelTotals();const cli=Object.values(CLI_TOOLS);",
"const by=(c)=>cli.filter(x=>x.category===c).length;",
// "Free forever" = every provider whose free access renews or needs no key at all.
- // one-time-initial (signup credits) and discontinued pools are excluded on purpose.
+ // one-time-initial (signup credits) and discontinued pools are excluded on purpose,
+ // and so is every eligibility-gated row: a provider nobody can sign up for without
+ // clearing a gate is not "free forever" for the reader of the headline.
"const FOREVER=new Set(['recurring-monthly','recurring-daily','recurring-uncapped',",
"'recurring-credit','keyless']);",
- "const ff=new Set();for(const m of t.perModel)if(FOREVER.has(m.freeType))ff.add(m.provider);",
+ "const ff=new Set();for(const m of t.perModel)",
+ "if(FOREVER.has(m.freeType)&&!m.eligibilityGate)ff.add(m.provider);",
'console.log("@@"+JSON.stringify({freeSteady:t.steadyRecurringTokens,entries:t.perModel.length,',
- "freeFirst:t.firstMonthRealisticTokens,freePools:t.poolCount,engines:ENGINE_IDS.length,",
+ "freeFirst:t.firstMonthRealisticTokens,freeGated:t.gatedRecurringTokens,",
+ "freePools:t.poolCount,engines:ENGINE_IDS.length,",
"cliTotal:cli.length,cliCode:by('code'),cliAgent:by('agent'),",
"mcpTools:countUniqueMcpTools(cols),mcpScopes:sc.size,providers:pids.size,freeForever:ff.size,",
"modePacks:Object.keys(MODE_PACKS),",
@@ -271,6 +275,20 @@ export function extractHeadlineClaims(content) {
return claims;
}
+// The eligibility-gated figure ("+~6M behind regional identity verification") is validated
+// with its own anchor so it can neither drift nor be silently dropped once it exists.
+const GATED_ANCHOR = /^\s*behind regional identity verification/i;
+
+export function extractGatedClaims(content) {
+ const claims = [];
+ for (const m of content.matchAll(/\+?~?(\d+(?:\.\d+)?)([BM])\b/g)) {
+ const after = content.slice(m.index + m[0].length, m.index + m[0].length + 60);
+ if (!GATED_ANCHOR.test(after)) continue;
+ claims.push({ tokens: Number(m[1]) * (m[2] === "B" ? 1e9 : 1e6), unit: m[2], text: m[0] });
+ }
+ return claims;
+}
+
export function checkFreeTierHeadline(content, totals) {
const claims = extractHeadlineClaims(content);
if (!claims.length) return { ok: true, detail: "no aggregate free-tier headline in this file" };
@@ -279,14 +297,31 @@ export function checkFreeTierHeadline(content, totals) {
const stale = claims.filter(
(c) => Math.abs(c.value - steady) >= 0.05 && Math.abs(c.value - first) >= 0.05
);
- if (!stale.length)
- return { ok: true, detail: `${claims.length} headline claim(s) match the live catalog` };
- return {
- ok: false,
- detail:
+ const problems = [];
+ if (stale.length) {
+ problems.push(
`stale headline ${[...new Set(stale.map((c) => c.text))].join(", ")} — live catalog ` +
- `computes ~${steady.toFixed(2)}B steady / ~${first.toFixed(2)}B first month`,
- };
+ `computes ~${steady.toFixed(2)}B steady / ~${first.toFixed(2)}B first month`
+ );
+ }
+ if (totals.g != null && totals.g > 0) {
+ const gated = extractGatedClaims(content);
+ const tol = (c) => (c.unit === "B" ? 0.05e9 : 0.5e6);
+ const gatedStale = gated.filter((c) => Math.abs(c.tokens - totals.g) >= tol(c));
+ if (!gated.length) {
+ problems.push(
+ `missing gated figure — live catalog computes ${Math.round(totals.g / 1e6)}M behind regional identity verification`
+ );
+ } else if (gatedStale.length) {
+ problems.push(
+ `stale gated figure ${[...new Set(gatedStale.map((c) => c.text))].join(", ")} — live catalog ` +
+ `computes ${Math.round(totals.g / 1e6)}M behind regional identity verification`
+ );
+ }
+ }
+ if (!problems.length)
+ return { ok: true, detail: `${claims.length} headline claim(s) match the live catalog` };
+ return { ok: false, detail: problems.join("; ") };
}
// PURE: docs prose that names the product version ("OmniRoute v3.8.50 ·",
@@ -599,12 +634,12 @@ export function buildChecks() {
},
{
label: "Free-tier headline (live catalog)",
- actual: `~${(f.freeSteady / 1e9).toFixed(2)}B steady / ${f.freePools} pools`,
+ actual: `~${(f.freeSteady / 1e9).toFixed(2)}B steady / ${f.freePools} pools / ${Math.round(f.freeGated / 1e6)}M gated`,
docKey: "free-tier headline",
strict: true,
files: ["README.md", "docs/reference/FREE_TIERS.md"],
validate: (content) =>
- checkFreeTierHeadline(content, { s: f.freeSteady, m: f.freeFirst }),
+ checkFreeTierHeadline(content, { s: f.freeSteady, m: f.freeFirst, g: f.freeGated }),
},
claim(
f.engines,
diff --git a/scripts/research/gen-budget-card-svg.mjs b/scripts/research/gen-budget-card-svg.mjs
index f253ded074c..f2c01b082ca 100644
--- a/scripts/research/gen-budget-card-svg.mjs
+++ b/scripts/research/gen-budget-card-svg.mjs
@@ -1,56 +1,81 @@
-// Generates docs/screenshots/free-tier-budget-card.svg from the per-model catalog.
-// Run: node scripts/research/gen-budget-card-svg.mjs
+#!/usr/bin/env node
+// Generates the free-tier budget card from the per-model catalog, through the
+// same function the docs gate and the dashboard use — never by parsing the data
+// file with a regex (that silently skipped every row carrying an extra field).
+// Run from the repo root:
+// node --import tsx/esm scripts/research/gen-budget-card-svg.mjs [--out path.svg]
import fs from "node:fs";
+import { computeFreeModelTotals } from "../../open-sse/config/freeModelCatalog.ts";
-const txt = fs.readFileSync("open-sse/config/freeModelCatalog.data.ts", "utf8");
-const recs = [
- ...txt.matchAll(
- /\{ provider: "([^"]+)", modelId: "([^"]+)", displayName: "([^"]+)", monthlyTokens: (\d+), creditTokens: (\d+), freeType: "([^"]+)", poolKey: (null|"[^"]+"), tos: "([^"]+)" \}/g
- ),
-].map((m) => ({
- provider: m[1],
- modelId: m[2],
- displayName: m[3],
- monthlyTokens: +m[4],
- creditTokens: +m[5],
- freeType: m[6],
- poolKey: m[7] === "null" ? null : m[7].slice(1, -1),
- tos: m[8],
-}));
+const outIdx = process.argv.indexOf("--out");
+if (outIdx >= 0 && !process.argv[outIdx + 1]) throw new Error("--out requires a path");
+const OUT = outIdx >= 0 ? process.argv[outIdx + 1] : "docs/screenshots/free-tier-budget-card.svg";
+const t = computeFreeModelTotals();
+const STEADY_TYPES = new Set(["recurring-daily", "recurring-monthly", "keyless"]);
const fmt = (n) =>
- n >= 1e9 ? (n / 1e9).toFixed(2) + "B" : n >= 1e6 ? Math.round(n / 1e6) + "M" : Math.round(n / 1e3) + "K";
+ n >= 1e9
+ ? (n / 1e9).toFixed(2) + "B"
+ : n >= 1e6
+ ? Math.round(n / 1e6) + "M"
+ : Math.round(n / 1e3) + "K";
+// One bar segment per steady pool (largest member), gated rows excluded like the headline.
const poolMap = new Map();
-for (const r of recs) {
- if (!["recurring-daily", "recurring-monthly", "keyless"].includes(r.freeType)) continue;
+for (const r of t.perModel) {
+ if (!STEADY_TYPES.has(r.freeType) || r.eligibilityGate) continue;
const k = r.poolKey || `${r.provider}:${r.modelId}`;
const cur = poolMap.get(k);
if (!cur || r.monthlyTokens > cur.monthlyTokens) poolMap.set(k, r);
}
-const pools = [...poolMap.values()].filter((r) => r.monthlyTokens > 0).sort((a, b) => b.monthlyTokens - a.monthlyTokens);
-const steady = pools.reduce((s, r) => s + r.monthlyTokens, 0);
+const pools = [...poolMap.values()]
+ .filter((r) => r.monthlyTokens > 0)
+ .sort((a, b) => b.monthlyTokens - a.monthlyTokens);
+const steady = t.steadyRecurringTokens;
+const firstMonth = t.firstMonthRealisticTokens;
+const gated = t.gatedRecurringTokens;
const otMap = new Map();
-for (const r of recs) {
- if (r.freeType !== "one-time-initial" || r.creditTokens <= 0) continue;
+for (const r of t.perModel) {
+ // Gated rows are excluded here too — they are absent from firstMonthRealisticTokens.
+ if (r.freeType !== "one-time-initial" || r.creditTokens <= 0 || r.eligibilityGate) continue;
const k = r.poolKey || r.provider;
otMap.set(k, { provider: r.provider, v: Math.max(otMap.get(k)?.v || 0, r.creditTokens) });
}
const oneTime = [...otMap.values()].sort((a, b) => b.v - a.v);
const oneTimeSum = oneTime.reduce((s, r) => s + r.v, 0);
-const firstMonth = steady + oneTimeSum;
-const avoidProviders = [...new Set(recs.filter((r) => r.tos === "avoid").map((r) => r.provider))].length;
-const uncappedProviders = [...new Set(recs.filter((r) => r.freeType === "recurring-uncapped").map((r) => r.provider))];
+const avoidProviders = new Set(t.perModel.filter((r) => r.tos === "avoid").map((r) => r.provider))
+ .size;
+const uncappedProviders = t.uncappedProviders;
const GRID = pools.slice(0, 28);
const STRIP = oneTime.slice(0, 9);
-const PAL = ["#6c5ce7","#00b894","#0984e3","#e17055","#fdcb6e","#e84393","#00cec9","#d63031","#a29bfe","#55efc4","#74b9ff","#ffeaa7","#fab1a0","#81ecec"];
+const PAL = [
+ "#6c5ce7",
+ "#00b894",
+ "#0984e3",
+ "#e17055",
+ "#fdcb6e",
+ "#e84393",
+ "#00cec9",
+ "#d63031",
+ "#a29bfe",
+ "#55efc4",
+ "#74b9ff",
+ "#ffeaa7",
+ "#fab1a0",
+ "#81ecec",
+];
const color = (i) => PAL[i % PAL.length];
-const cleanName = (r) => (r.displayName || r.provider).replace(/\s*\(.*$/, "").replace(/ —.*$/, "").slice(0, 24);
+const cleanName = (r) =>
+ (r.displayName || r.provider)
+ .replace(/\s*\(.*$/, "")
+ .replace(/ —.*$/, "")
+ .slice(0, 24);
-// bar segments (min width so every pool shows)
-const BAR_X = 32, BAR_W = 836, MIN = 7;
+const BAR_X = 32,
+ BAR_W = 836,
+ MIN = 7;
const extra = BAR_W - MIN * GRID.length;
let bx = BAR_X;
const segs = GRID.map((r, i) => {
@@ -60,11 +85,13 @@ const segs = GRID.map((r, i) => {
return s;
});
-const B = []; // body elements
-// title
-B.push(`Monthly free-token budget `);
-B.push(`${pools.length} free pools · ${recs.length} models · one endpoint `);
-// stats
+const B = [];
+B.push(
+ `Monthly free-token budget `
+);
+B.push(
+ `${pools.length} free pools · ${t.modelCount} models · one endpoint `
+);
const stat = (sx, label, val, vc) => {
B.push(`${label} `);
B.push(`${val} `);
@@ -72,50 +99,90 @@ const stat = (sx, label, val, vc) => {
stat(32, "Steady / month", `~${fmt(steady)}`, "#e6edf3");
stat(330, "First month (+ signup credits)", `~${fmt(firstMonth)}`, "#3fb950");
stat(700, "ToS-flagged (you decide)", `${avoidProviders} providers`, "#d29922");
-// bar
-B.push(`Each segment = one free pool · widths floored so every provider shows · honest numbers in the grid. `);
-// model grid 4 cols
-const COLS = 4, COLW = 213, GX = 32, GY = 200, RH = 30;
+B.push(
+ `Each segment = one free pool · widths floored so every provider shows · honest numbers in the grid. `
+);
+const COLS = 4,
+ COLW = 213,
+ GX = 32,
+ GY = 200,
+ RH = 30;
GRID.forEach((r, i) => {
- const col = i % COLS, row = (i / COLS) | 0;
- const cx = GX + col * COLW, cy = GY + row * RH;
+ const col = i % COLS,
+ row = (i / COLS) | 0;
+ const cx = GX + col * COLW,
+ cy = GY + row * RH;
B.push(`${cleanName(r)} ${fmt(r.monthlyTokens)} `);
+ B.push(
+ `${cleanName(r)} ${fmt(r.monthlyTokens)} `
+ );
});
let y = GY + Math.ceil(GRID.length / COLS) * RH + 6;
-// first-month strip (wrapping)
B.push(`+ First month: one-time signup credits (~${fmt(oneTimeSum)}) `);
+B.push(
+ `+ First month: one-time signup credits (~${fmt(oneTimeSum)}) `
+);
y += 24;
let sxp = 32;
for (const r of STRIP) {
const label = `${r.provider} ${fmt(r.v)}`;
const w = 16 + label.length * 6.7;
- if (sxp + w > 862) { sxp = 32; y += 30; }
- B.push(`${label} `);
+ if (sxp + w > 862) {
+ sxp = 32;
+ y += 30;
+ }
+ B.push(
+ `${label} `
+ );
sxp += w + 8;
}
y += 26;
-// ToS note (softened)
-B.push(`Pool-deduped, honest counting — no inflated rate-limit ceilings. Some terms suggest personal-use only; we flag them so you decide. `);
-B.push(`+ ${uncappedProviders.length} permanently-free, no-cap providers (e.g. ${uncappedProviders.slice(0, 3).join(", ")}) · OpenRouter $10 → +24M/mo. `);
-y += 34;
-const H = y + 24; // card content bottom
+const noteH = gated > 0 ? 48 : 34;
+B.push(
+ `Pool-deduped, honest counting — no inflated rate-limit ceilings. Some terms suggest personal-use only; we flag them so you decide. `
+);
+B.push(
+ `+ ${uncappedProviders.length} permanently-free, no-cap providers (e.g. ${uncappedProviders.slice(0, 3).join(", ")}) · OpenRouter $10 → +${fmt(t.boostMonthlyTokens)}/mo. `
+);
+if (gated > 0) {
+ B.push(
+ `+ ~${fmt(gated)} behind regional identity verification (${t.gatedProviders.join(", ")}) — real quota, never in the headline. `
+ );
+}
+y += noteH;
+const H = y + 24;
const CANVAS = H + 16;
const out = [];
-out.push(``);
+out.push(
+ ``
+);
out.push(`OmniRoute · /dashboard/free-tiers · preview mockup `);
+out.push(
+ `OmniRoute · /dashboard/free-tiers · preview mockup `
+);
out.push(...B);
out.push(` `);
-fs.writeFileSync("docs/screenshots/free-tier-budget-card.svg", out.join("\n") + "\n");
-console.log(`SVG: ${GRID.length} models, ${STRIP.length} first-month chips, canvas ${CANVAS}px. steady=${fmt(steady)} firstMonth=${fmt(firstMonth)} oneTime=${fmt(oneTimeSum)}`);
+fs.writeFileSync(OUT, out.join("\n") + "\n");
+console.log(
+ `SVG → ${OUT}: ${GRID.length} pools, ${STRIP.length} first-month chips, canvas ${CANVAS}px. steady=${fmt(steady)} firstMonth=${fmt(firstMonth)} gated=${fmt(gated)} oneTime=${fmt(oneTimeSum)}`
+);
diff --git a/src/app/(dashboard)/dashboard/usage/components/FreeBudgetCard.tsx b/src/app/(dashboard)/dashboard/usage/components/FreeBudgetCard.tsx
index 4fd8dff8ede..4e5ecaadca3 100644
--- a/src/app/(dashboard)/dashboard/usage/components/FreeBudgetCard.tsx
+++ b/src/app/(dashboard)/dashboard/usage/components/FreeBudgetCard.tsx
@@ -33,6 +33,10 @@ export interface FreeBudgetData {
boostMonthlyTokens?: number;
/** Providers that are permanently free but publish no token cap (rate/concurrency-limited). */
uncappedProviders?: string[];
+ /** Pool-deduped tokens/mo behind a regional identity check — real quota, never in the headline. */
+ gatedRecurringTokens?: number;
+ /** Providers behind that check. */
+ gatedProviders?: string[];
headline?: string;
/** ISO timestamp of the last catalog update. Absent/null → freshness is not shown. */
catalogUpdatedAt?: string | null;
@@ -88,6 +92,7 @@ interface FreeBudgetLabels {
segmentHint: string;
boost: (tokens: string) => string;
uncapped: string;
+ gated: (tokens: string) => string;
tosRestricted: (count: number) => string;
provider: string;
model: string;
@@ -111,6 +116,8 @@ const DEFAULT_LABELS: FreeBudgetLabels = {
`Unlock ~${tokens} more/mo with a one-time $10 OpenRouter top-up (50 → 1000 req/day)`,
uncapped:
"Permanently free, no published cap (rate-limited) — real access, not counted in the headline:",
+ gated: (tokens) =>
+ `~${tokens}/mo more behind a regional identity check — real quota, not counted in the headline:`,
tosRestricted: (count) =>
`${count} model${count === 1 ? "" : "s"} flagged as ToS-restricted — you decide`,
provider: "Provider",
@@ -339,6 +346,8 @@ export function FreeBudgetView({
perModel,
boostMonthlyTokens = 0,
uncappedProviders = [],
+ gatedRecurringTokens = 0,
+ gatedProviders = [],
catalogUpdatedAt,
noCredentialProviders = [],
} = data;
@@ -429,9 +438,7 @@ export function FreeBudgetView({
lock_open
-
- {labels.noApiKey}
-
+ {labels.noApiKey}
({keylessModels.length}个模型 · {keylessProviders.length}个提供者)
@@ -475,6 +482,23 @@ export function FreeBudgetView({
+