Start here
Quickstart
One base URL, one key, one request.
MiniRouter is one OpenAI-compatible API in front of many models and providers. Point an existing client at https://api.minirouter.sh/v1 with a MiniRouter key and it works unchanged: MiniRouter picks the provider, tries another one before the first byte if it fails, and reports the exact cost of every request.
Keys are created before any payment, and no account is required. Pick the way in that fits your project:
| Approach | Best for |
|---|---|
| Any OpenAI SDK | Existing apps. Change the base URL and key, keep your code. |
| HTTP or cURL | Any language, no dependencies. The three steps below. |
| Editors and agents | Cline, Kilo Code, OpenCode, Continue, Aider, Zed and other clients. |
| An agent of its own | Its own key, model and spend limits. |
Your first request, end to end
Three steps. One connection.
Keep your key somewhere safe.
Create a key, save it with your dashboard link, then set it in your terminal.
Get an API keyexport MINIROUTER_KEY=mr-live-your-key1 of 3
Go deeper
Start with a key.
Create a key, keep it safe, connect your client.
AuthenticationFind your model.
Model IDs, features and your first request.
Model guideUnderstand your route.
How requests move between providers when one fails.
Routing and failoverKnow what you pay.
Prepaid credits, deposits and request costs.
Billing guideQuestions
Do I need an account?
No. Get a key, then save the key and your permanent dashboard link somewhere safe, like a password. Important: without an account, if you lose both the key and the dashboard link, you lose your balance. Add an email or wallet to be able to recover it.
How do payments work?
Add prepaid credit with crypto or a card. USDC on Solana starts at $0.50 and other crypto at $5, with no MiniRouter deposit fee. Cards start at $20 and add a 3.5% processing fee. MINI credits 5% extra. Credits buy inference and cannot be withdrawn.
Can I use my own provider keys?
Yes. Connect OpenAI, Anthropic or DeepSeek keys for supported requests. One enabled key per provider has a 0% MiniRouter service fee; multiple enabled keys for the same provider cost 3% of published-rate usage. Your provider bills inference separately.
What happens to my prompts?
Prompts, responses, and tool content are saved in private debug traces for debugging. Those traces expire after 30 days. There is no opt-out. Each upstream provider has its own data policy.
Which models can I use?
The published catalog is the source of truth. Choose a model there to see its price, context window, supported features, and setup instructions.