Python · cascade routing · anthropic

AWS Lambda: cascade routing in one line

Prompts the deterministic classifier scores as simple are routed to the cheaper sibling of the model you asked for, inside the same provider, with a shadow-parity breaker. Here is the change for AWS Lambda, the switch that turns it on, and the arithmetic on claude-sonnet-5-5.

AWS Lambda reaches TokenZero with one base-URL argument and keeps your anthropic key. The cascade sibling of claude-sonnet-5-5 is claude-haiku-5-5 at $0.00035 per reference call against $0.00700; if every call were simple that is $665 a month on 100,000 calls, and a 99.8% parity floor with shadow evaluation decides whether a pair stays enabled.

· Source: pricing table 2026-10-26; overhead from the published benchmark on /benchmarks

At a glance

Framework
AWS Lambda (Python)
Capability
cascade routing
Change
handler.py: base URL argument
Request shape
Anthropic Messages
Turn it on
X-TokenZero-Cascade: auto
Workspace setting
cascade: auto, shadowEval: true
Reference model
claude-sonnet-5-5 ($2.00 in / $10.00 out per 1M, table 2026-10-26)
Cascade saving if every simple call moves
$665/month to claude-haiku-5-5 (computed)
Gateway overhead (measured)
1.52 ms p50, 3.42 ms p95
Parity floor
99.8%
Free tier
$500/month routed spend

Reference workload on claude-sonnet-5-5: 2,000 input (1,500 static) / 300 output tokens, 100,000 calls per month, table 2026-10-26

ScenarioPer callPer monthDelta
List price, no gateway$0.00700$700—
Static prefix cached (prompt compression)$0.00415$415$285 (41%)
20% exact-cache repeats$0.00560$560$140 (20%)
All calls cascaded to claude-haiku-5-5$0.00035$35$665 (95%)
Budget guardrail at $500/month—capped at $500.00402 after 71,428 calls

The change

1. Point AWS Lambda at the gateway (handler.py):

-client = Anthropic()
+client = Anthropic(base_url="https://tokenzero.sh")
 def handler(event, context):
     return client.messages.create(model="claude-sonnet-5-5", max_tokens=512, system=SYSTEM, messages=event["messages"]).model_dump()

Cold starts are unaffected: the gateway holds no connection state your function needs.

2. Turn on cascade routing. Per request: X-TokenZero-Cascade: auto (default advise: the recommendation is returned in X-TokenZero-Cascade-Recommendation and nothing moves). Per workspace (applies to every call without touching code): PATCH /v1/workspaces/settings {cascade: auto, shadowEval: true} or the dashboard toggle.

3. Prove it. npx -y @tokenzero/cli doctor checks the gateway, the signer, the pricing table and your key; then watch routed share and parity per pair on the scorecard.

Questions people ask

How do I point AWS Lambda at TokenZero?

Pass base_url / baseURL = https://tokenzero.sh where AWS Lambda builds its client (handler.py) and keep your anthropic key; nothing else changes.

What does cascade routing save on claude-sonnet-5-5?

The cascade sibling of claude-sonnet-5-5 is claude-haiku-5-5 at $0.00035 per reference call against $0.00700; if every call were simple that is $665 a month on 100,000 calls, and a 99.8% parity floor with shadow evaluation decides whether a pair stays enabled.

Does cascade routing change the model's output?

Only when a prompt is scored simple and the pair is above the 99.8% parity floor; shadow evaluation re-runs a sample on the original model, and a pair that drops below the floor is auto-disabled. Everything else goes to the model you asked for.

What does TokenZero cost?

Free up to $500 per month of routed spend; then 15% of verified savings with a 3x-ROI-or-$0 rule, capped plans available. Gateway overhead measured at 1.52 ms p50.

Related

Simulate the cascade on your prompt mix

Add cascade routing to AWS Lambda now: swap the base URL, keep your anthropic key, get a signed receipt per call.Start free