ZevRouter trial guide

Try ZevRouter with one small workload

A product guide for deciding whether ZevRouter is a valid small API trial: OpenAI-compatible usage, readable receipts, direct-provider cost basis, and ZEV City's three positive loops for clean-energy participation in one path.

What ZevRouter is

ZevRouter is ZEV City's hosted OpenAI-compatible API router at router.zev.city. It is meant to be tested first with a supported model and a small non-critical workload, not as an immediate full replacement for a broad model marketplace.

The useful question is whether one small trial gives enough API behavior, cost visibility, receipts, and clean-energy record visibility to justify continuing with supported workloads.

First trial checklist

A good first test is a bounded developer check, not a migration decision. Keep your current provider or OpenRouter route active while you inspect the ZevRouter path.

  1. Choose one currently supported model from the ZevRouter model list.
  2. Use a low budget, such as the smallest practical top-up or trial credit available.
  3. Send one non-sensitive, non-production request through the OpenAI-compatible endpoint.
  4. Record the output, latency, success or failure state, and any fallback metadata.
  5. Check whether the request cost follows provider-cost basis plus the 5% service uplift.
  6. Open the request receipt, credit activity, and clean-energy record links before increasing usage.

Supported-model scope

First-trial target
One visible supported model, not the whole model market.

Start with a model currently shown on the ZevRouter model catalog or trial entry. Broad unsupported routes should stay on OpenRouter or direct providers.

Current catalog posture
Focused Gemini and Claude-family routes for bounded trials.

This guide states the bounded trial scope. A first test should use one model that is currently available to the tester in the ZevRouter product UI.

How to judge utility
Measure the request you can actually run.

A small trial should judge one supported request's answer quality, latency, cost, receipt, and record trail before any larger workload.

Why this exists

AI API usage is becoming a new energy demand. ZevRouter is ZEV City's experiment in turning ordinary AI service margin into user-visible clean-energy participation, starting with small, checkable receipts before asking anyone to trust a larger claim.

This is not framed as a one-time carbon-offset label. The product direction is an ongoing relationship between usage and participation: users can inspect receipt math, cost basis, credits, selected participation path, clean-energy destination, reviewer hashes, and settlement records as those layers mature.

ZevRouter should therefore be evaluated as the AI-usage entry point into ZEV City's three positive loops: an energy loop, a participation/reward loop, and a community-impact loop.

Three positive loops

The core question is not only whether ZevRouter can route one API call. It is whether AI usage can become a repeatable participation path where usage records, clean-energy records, and community project choices reinforce each other over time.

Loop 1
Energy loop: usage margin becomes clean-energy records.

A small AI top-up can create inspectable receipt, provider-cost, service-uplift, allocation, destination, reviewer, and settlement records. Current evidence is strongest for receipts, Base registry anchoring, Reading solar context, and PUNL school-solar context.

Loop 2
Participation / reward loop: users see how their usage maps into participation.

The API-credit path currently records $2 clean-energy participation per $100 provider-credit basis. The energy-participation path records $4 total, including $3 user-facing energy participation and $1 ZEV reserve. These are participation records, not cash redemption promises.

Loop 3
Community-impact loop: participation can guide future project choice.

The long-term model lets users and communities help steer clean-energy destinations. Current governance, voting, and project-choice mechanisms should be treated as future reviewed layers that need eligibility rules, anti-abuse review, and operator approval before being described as production governance.

The fair evaluation standard is practical: judge the current router on API behavior, cost visibility, receipt clarity, and whether these three loops are becoming verifiable instead of only being stated as a mission.

Cost and receipt basis

Current accounting rule
Direct model-provider cost basis plus a 5% service uplift.

OpenRouter is treated as backend fallback only when used and should be recorded separately.

Sample top-up
$105 paid top-up, $100 provider-credit basis, $5 service uplift.

The current operator-controlled beta receipt journey turns this into a user-inspectable path.

User choice
API-credit path or energy-participation path.

The API-credit path directs $2 toward clean-energy participation records. The energy-participation path directs $4 total toward clean-energy participation records, split into $3 user-facing energy participation and a $1 ZEV reserve record.

What the three loops add
The user can evaluate a system, not only a ledger.

The relevant questions are: does usage create a clear energy record, does the user see a participation path, and can project choice become reviewable instead of opaque?

Physical energy context

ZevRouter's clean-energy participation records point to real ZEV City surfaces, not only abstract JSON. Current public context includes a Reading-area residential solar + battery generation surface and Power Up North London school-solar participation context.

Reading-area solar + battery
Public generation data surface.

Daily and realtime feeds make the generation context inspectable. A reviewed allocation record is the next stronger proof layer.

PUNL Camden school solar
Portfolio-linked participation context.

The public surface references Power Up North London school-solar participation, including Camden schools such as Parliament Hill School and Regent High School.

Base registry path
Policy v2 and internal/trial records are anchored.

The registry records hashed payment, provider-cost, destination, allocation, reviewer, user-choice, and settlement fields for AI top-up allocation commitments.

How to test safely

  1. Use ZevRouter for one supported model request or one agent harness test.
  2. Compare output, latency, reliability, and cost against your current provider or OpenRouter route.
  3. Inspect credits, activity, generation receipt, and energy records before increasing usage.
  4. Keep OpenRouter or a direct provider route for broad model coverage, unsupported models, and high-volume production until ZevRouter has the needed history for your use case.

Receipt fields and reliability check

Receipt fields
A first-trial receipt should show model, route, cost basis, credit debit, and energy-record linkage.

Inspect the field reference at request-receipt-sample.json, then compare it with the receipt generated by the user's own trial request.

Reliability check
Measure your own small request and compare it with the rolling history as it grows.

For now, treat latency and success as trial observations. Longer uptime, p95 latency, and incident history remain confidence milestones.

Boundary
Trial evidence is useful, but it is not a production SLA.

The practical question is whether the first request is inspectable enough to justify the next supported workload.

What is checkable now

Next confidence milestones