Skip to content

Rewrite BitRouter vs OpenRouter, fix stale platform-fee claims - #62

Merged
SPIKESPIGEL404 merged 1 commit into
mainfrom
claude/bitrouter-openrouter-rewrite-6f9213
Aug 7, 2026
Merged

Rewrite BitRouter vs OpenRouter, fix stale platform-fee claims#62
SPIKESPIGEL404 merged 1 commit into
mainfrom
claude/bitrouter-openrouter-rewrite-6f9213

Conversation

@SPIKESPIGEL404

Copy link
Copy Markdown
Contributor

Rewrites /docs/overview/bitrouter-vs-openrouter as a short, conversational page, and fixes a pricing claim that was contradicting itself across the repo.

The page

The old version argued on agent-native primitives (KYA, x402, MCP gateway, injection checks) and a ~5ms vs ~30ms latency gap. Neither holds up as a differentiator — OpenRouter is also low-latency and agent-native — so both are gone. The page now argues the three things that actually differ:

  1. Fully open source and self-hostable — Apache 2.0, runs in your VPC; OpenRouter is closed-source cloud only.
  2. We take no cut — 0% markup, BYOK free.
  3. The router learns your workload — the act → observe → evaluate → learn loop, versus a static auto-router.

And three honest reasons to pick OpenRouter instead: catalog breadth, free-tier models, and enterprise depth.

The intro opens by crediting OpenRouter for building the category before pivoting to what we're betting on — the enumeration it replaced was scaffolding the bolded lead-ins already provided.

The pricing fix

The repo said two different things about what BitRouter charges:

  • 0% markup — pricing page, models page, lib/llms-shared.ts, enterprise and startup pages
  • 2% stablecoin / 5% card — three CompareTable rows and the migration guide

0% is correct. Fixed all four stale spots (the OpenRouter, LiteLLM, and Portkey comparison rows, plus migrate-from-openrouter.mdx). Left alone, the vs-OpenRouter page would have claimed 0% in prose with a table two inches below saying 2%.

The prose also concedes that OpenRouter passes inference through at 0% too, then names the fees that genuinely differ — 5.5% to load credits, 5% on BYOK past their free allowance. Conceding the shared ground is what makes the rest credible to a reader who already knows their pricing.

The table

Cut from 10 rows to 5, one per argument. Ten rows ran longer than the prose it supported, restated the "when OpenRouter wins" section, and turned the page into a scorecard against a catalog we deliberately don't try to match.

Verified

  • pnpm lint:docs passes (49 docs)
  • Page renders correctly in dev; no new console errors
  • tsc shows only pre-existing errors in components/ai/search.tsx and components/markdown.tsx

Before merging

  • Verify OpenRouter's current fees. 5.5% on credits and 5% on BYOK are now stated as fact in three files, and their pricing moves.
  • "We've learned plenty from them" in the intro is a claim about the team, not a checkable fact — confirm it's one we want to make publicly.

🤖 Generated with Claude Code

The page argued on agent-native primitives (KYA, x402, injection checks)
and a ~5ms vs ~30ms latency gap — neither is a real differentiator against
OpenRouter, which is also low-latency and agent-native. Rewrote it around
the three things that actually differ: we're fully open source and
self-hostable, we take no cut, and the router learns your workload.

The intro now credits OpenRouter for building the category before pivoting,
rather than opening with an enumeration the bolded lead-ins already cover.

Fee claims were contradictory across the repo: the pricing page, models
page and llms-shared.ts all said 0% markup, while three CompareTable rows
and the migration guide said "2% stablecoin / 5% card". 0% is correct;
fixed all four stale spots. The vs-OpenRouter prose now concedes that
OpenRouter passes inference through at 0% too, and names the two fees that
genuinely differ (5.5% to load credits, 5% on BYOK).

Cut the comparison table from 10 rows to 5 — one per argument. Ten rows
was longer than the prose it supported, repeated the "when OpenRouter wins"
section, and invited row-counting against a catalog we don't try to match.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@SPIKESPIGEL404
SPIKESPIGEL404 merged commit 5670126 into main Aug 7, 2026
1 check passed
SPIKESPIGEL404 added a commit that referenced this pull request Aug 7, 2026
PR #62 landed the OpenRouter rewrite and its own platform-fee fix, hitting
the same registry file. Resolution:

- LiteLLM rows: ours (the 5-row trim is what this PR is for)
- OpenRouter rows: main's — #62 rewrote that comparison deliberately, and
  it is not this PR's business
- Portkey fee row: main's "none · 0% markup" phrasing, now the house style,
  superseding the equivalent change made here

Net effect: this branch's diff against main is now only the LiteLLM entry.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant