# Hopscotch

Cost and quality in the same call. Every model, one API.

Send hopscotch/auto in a cost tier: low, balanced, or high. Lower is cheaper. Higher is more capable. Name a model and that is what runs.

OpenAI-compatible base URL: https://hopscotchlabs.ai/v1
Dashboard: https://platform.hopscotchlabs.ai

Upstreams: Anthropic, Cohere, DeepInfra, DeepSeek, Fireworks AI, Google, Meta, MiniMax, Moonshot AI, OpenAI, Z.ai.

## FAQ

### Do I have to change my code?

One line: the base URL. Anthropic, OpenAI, Google, and the rest of the catalog answer on it. Keep the client you already have. Streaming, tools, effort, and structured output pass through.

### How do cost tiers work?

Send hopscotch/auto and pick a cost tier: low, balanced, or high. Lower is cheaper. Higher is more capable. Auto picks a model inside that band. Name a model instead and that is what runs.

### Can a model I named be swapped for a cheaper one?

No. A model you named is what runs. If it cannot run, you get an error rather than a stand-in. Auto is the one case where we pick, and it is a slug you send on purpose, hopscotch/auto, inside the cost tier you set.

### Do you change my request or the answer?

No. Your system prompt and your messages reach the upstream the way you sent them, and one model answers: we do not blend two responses and hand you the seam.

### What happens when a provider fails?

Failover is classified, not guessed. A 429 is retried once on the same route and then treated as capacity; an unavailable provider or a long Retry-After moves on and puts that route on cooldown; a malformed request or a context-length error is never retried, because retrying it would only fail again.

### Do you mark up the token price?

No. The catalog price is the upstream price. When that provider serves a cached read, you pay their cached rate. Reasoning tokens bill as completion, which is how the provider charges us for them.

### Can I use my own provider keys?

Yes. One upstream secret per provider per project, tried before the shared pool. Tokens spent on your own key are not debited from your balance and carry no percentage on top.

### What stops an agent in a loop from draining the balance?

Two limits and a refusal. A ceiling caps what any single call may cost, a cap caps what the project may spend, and a call that would cross either is rejected pre-flight: no upstream request, no ledger debit, and an error your code can catch.

### Can I see which model actually answered?

Every response carries the model, the hop count, and the outcome in its headers. The requests log keeps the full attempt chain: which upstream served it, which ones were tried, how each failed, which key signed the call, and which cap it drew from.

### Can I pin a model version?

Name the exact slug and you are pinned. Aliases exist so a shorter name survives a version bump, which means pinning is a decision you make rather than one you inherit.

### How do I pay?

You buy tokens and spend them at list price. Top up from $10, with optional auto-reload at 20% remaining. No plan. Turn auto-reload off and the balance runs out and tells you.

### Do you have an enterprise plan?

No. Same product. Email us for an invoice, a volume commit, or an MSA.