Routes and billing
Per-route credential, billing, egress, failover, and limitation disclosures.
Routes and billing
This page is the public RouteKit launch-support disclosure. The maintainer
mirror lives at
docs/routekit-routes-and-billing.md.
The current first-launch contract contains six routes, all Planned Supported
until L06 closes. Historical L06 evidence references RouteKit 0.8.0 revision
dad16c53c0e083a51d41df59149a21964d27cc12
(2026-07-22) and the
end-to-end matrix.
That immutable report contains a historical Cursor row that is not a current
support claim. See client compatibility
for the exact supported client builds and separate 2026-08-01 Cursor evidence.
Shared contract
- A requested namespaced model never falls through to another provider.
- API routes have no RouteKit account-pool or cross-provider failover.
- Subscription pools rotate only among eligible accounts of the same kind.
- RouteKit makes no unlimited-use claim. Provider terms and quotas always apply.
- Portable message and tool history can cross compatible routes. Opaque encrypted reasoning is retained only for its originating provider and native model.
Inspect a live route with:
routekit models info <provider/model>The response includes namespaced and native model IDs, provider, account class,
billing mode (api-key / metered-api, subscription / subscription), and
capabilities. Unknown models fail. Credentials are never returned. See also
route explanation evidence.
OpenAI API
- Status and evidence: Planned Supported until L06 closes. L06 Pass for
openai/gpt-5.5, RouteKit 0.8.0 / 2026-07-22. Evidence. - Credential: User-owned
OPENAI_API_KEY; optionalOPENAI_BASE_URL. - Billing: Metered API-key route; OpenAI determines charges.
- Egress and aggregator: Direct to
api.openai.comunless overridden. No aggregator. - Quota and failover: Provider errors return to the caller; no account pool and no silent cross-provider fallback.
- Protocol and limitations: OpenAI Chat Completions and native Responses.
Direct OpenAI API routes keep
/v1/responsesrequests on the native Responses endpoint, preserving tools, reasoning, streaming, continuation IDs, and opaque response items without translating through Chat Completions. - Unlimited use: RouteKit makes no unlimited-use claim.
Anthropic API
- Status and evidence: Planned Supported until L06 closes. L06 Pass for
anthropic/claude-sonnet-4-6, RouteKit 0.8.0 / 2026-07-22. Evidence. - Credential: User-owned
ANTHROPIC_API_KEY; optionalANTHROPIC_BASE_URL. RouteKit does not currently useANTHROPIC_AUTH_TOKENfor provider requests. - Billing: Metered API-key route; Anthropic determines charges.
- Egress and aggregator: Direct to
api.anthropic.comby default. No aggregator. - Quota and failover: Provider errors return to the caller; no account pool.
- Protocol and limitations: Native Messages with streaming, tools, and thinking where supported.
- Unlimited use: RouteKit makes no unlimited-use claim.
Amazon Bedrock
- Status and evidence: Planned Supported until L06 closes. L06 pending — authorized-operator qualification, RouteKit 0.8.0 / 2026-07-22. Evidence.
- Credential: Operator-owned AWS SDK default-chain identity and region; see the AWS Bedrock guide.
- Billing: Direct AWS Bedrock Runtime route; AWS determines charges and credits are account-specific.
- Egress and aggregator: Direct to AWS Bedrock in the configured account and region. No aggregator, though cross-region inference profiles can route to AWS destination regions.
- Quota and failover: AWS model access, IAM, service quotas, and throttling apply. Provider errors return to the caller; no silent cross-provider fallback.
- Protocol and limitations: Live model and inference-profile discovery plus Bedrock Runtime invocation. Availability, streaming, tools, and reasoning vary by model and region.
- Unlimited use: RouteKit makes no unlimited-use claim.
OpenRouter API
- Status and evidence: Planned Supported until L06 closes. L06 Pass for
openrouter/openai/gpt-4o-mini, RouteKit 0.8.0 / 2026-07-22. Evidence. - Credential: User-owned
OPENROUTER_API_KEY. - Billing: OpenRouter API-key/credit route; OpenRouter determines charges.
- Egress and aggregator: OpenRouter is an aggregator. RouteKit sends
prompts, code, tool data, and model requests to
openrouter.ai, which forwards them to an upstream provider under OpenRouter routing. - Quota and failover: No RouteKit account pool or silent direct-provider switch.
- Protocol and limitations: OpenAI Chat Completions; tools and streaming depend on OpenRouter and the upstream model.
- Unlimited use: RouteKit makes no unlimited-use claim.
Codex subscription
- Status and evidence: Planned Supported until L06 closes. L06 Fail —
account-unavailable, RouteKit 0.8.0 / 2026-07-22. Evidence. - Credential: User-owned Codex OAuth credential from
accounts login codex. - Billing: Subscription plan usage determined by the provider.
- Egress and aggregator: Relays to
chatgpt.com/backend-api/codexwith the enrolled OAuth credential; neverOPENAI_API_KEY. No third-party aggregator. - Quota and failover: Rotates eligible Codex accounts only. Before response output is committed, credential-scoped authentication failures can trigger coalesced refresh and reroute to a healthy account in the same pool. Exhaustion never invokes a paid OpenAI API-key route.
- Protocol and limitations: OpenAI Responses with streaming and tools. The
exact supported Codex CLI build is
0.146.0; see client compatibility. - Unlimited use: RouteKit makes no unlimited-use claim.
Claude Code subscription
- Status and evidence: Planned Supported until L06 closes. L06 Fail —
account-unavailable, RouteKit 0.8.0 / 2026-07-22. Evidence. - Credential: User-owned Claude Code OAuth credential from
accounts login claude-code. - Billing: Subscription plan usage determined by Anthropic.
- Egress and aggregator: Relays to Anthropic with the enrolled OAuth
credential; never
ANTHROPIC_API_KEY. No third-party aggregator. - Quota and failover: Same-kind eligible-account rotation. Before response output is committed, credential-scoped authentication failures can trigger coalesced refresh and reroute within that pool. Exhaustion never invokes a paid Anthropic API-key route.
- Protocol and limitations: Native Anthropic Messages relay with streaming
and tools. The exact supported Claude Code builds are
2.1.216and2.1.220; see client compatibility. - Unlimited use: RouteKit makes no unlimited-use claim.
Not offered client surfaces
Cursor Desktop is not part of the current launch contract. On 2026-08-01,
Cursor Desktop 3.12.30 rejected RouteKit model names before sending a gateway
request. See the
sanitized qualification record.
The retained /v1/cursor adapter is an internal compatibility surface, not a
support declaration. cursor-agent is also not offered because it expects
Cursor's backend/ACP protocol rather than an OpenAI-compatible gateway.
Qualification evidence
Public route status stays conditional until L06 closes. The durable evidence map is routekit-l06-evidence.md. Its Cursor row is retained as historical evidence and is not a current route. Maintainer qualification notes live in routekit-routes-and-billing.md.

