How to Get an OpenRouter API Key and Use Free Models
Create an OpenRouter API key, see the free-model limits, fix 401, 402 and 429 errors, and use OpenRouter on iPhone, Android or the web.
- To get an OpenRouter API key, sign in at openrouter.ai, open openrouter.ai/keys and create a key; it starts with "sk-or-v1-". The key is free to create, models whose IDs end in ":free" can be used within daily limits, and every other model is paid from prepaid credits.
- OpenRouter is one account and one key for models from many AI companies. It doesn’t publish its own chat app for iPhone or Android, so on a phone you use a chat app that accepts an OpenRouter key, such as Oriveo.
- As of 18 November 2026, free models allow 20 requests a minute and 50 a day, or 1,000 a day once you have bought at least 10 credits. Error 402 means you are out of credits.

What is OpenRouter, and what is an API key?
OpenRouter is a service that gives you models from many AI companies through one account. Instead of signing up with each company, you add credits to OpenRouter once and choose models from its list.
An API key is the secret code an app uses to make requests on your account. OpenRouter checks the key, sends your message to the model you picked, and takes the cost from your OpenRouter credits.
OpenRouter is built for apps and developers. It doesn’t publish its own iPhone or Android chat app, which is why people search for an "OpenRouter app". What they need is a chat app that accepts an OpenRouter key.
How do I get an OpenRouter API key?
It takes a couple of minutes on the OpenRouter website.
- Go to openrouter.ai and create an account, or sign in.
- Open the keys page at openrouter.ai/keys and create a new key. Name it after the app or device you’ll use it on.
- Copy the key. OpenRouter keys start with "sk-or-v1-" and are 73 characters long, so check that you copied all of it.
- If you want models that aren’t free, add credits on the Credits page.
- Keep the key somewhere safe, such as a password manager. If it leaks, delete it on the keys page and create a new one.
Is the OpenRouter API free?
Partly. Creating an account and a key costs nothing, and OpenRouter offers free models whose IDs end in ":free". Everything else is paid from prepaid credits. OpenRouter also says new users get a small amount of free credit, but doesn’t say how much.
Free models come with limits. These are OpenRouter’s published limits as of 18 November 2026:
- If your balance drops below zero, OpenRouter says even free models may return errors.
- OpenRouter’s site shows which models currently have a ":free" version; check there before you rely on one.
| Your account | Free-model requests per minute | Free-model requests per day |
|---|---|---|
| Bought fewer than 10 credits in total | 20 | 50 |
| Bought at least 10 credits in total | 20 | 1,000 |
How do OpenRouter credits work?
OpenRouter is prepaid. You buy credits on the Credits page with a card or one of the other payment methods listed there, and each request is deducted from them. As of 18 November 2026, OpenRouter’s terms set a minimum of $5 per purchase, add a payment fee, and say unused credits may expire 365 days after purchase. See openrouter.ai/terms for the current details.
Each model has its own per-token price, shown on its page on OpenRouter. We don’t copy prices here because they change. Oriveo shows an estimated cost on every reply; OpenRouter’s activity and billing pages are the final record.
How do I use OpenRouter on iPhone, Android or the web?
Because there is no official OpenRouter mobile app, you choose a client app. In Oriveo, OpenRouter is one of 15 built-in providers, listed under Aggregators, so you don’t type an address.
- Open Providers: a tab on iPhone and Android, or the sidebar on the web.
- Tap the + button (Add Provider), then choose OpenRouter. The Aggregators chip narrows the list.
- Paste your key under "Connect OpenRouter" and tap Continue.
- Wait for "Validating connection and syncing models...". Oriveo loads OpenRouter’s model list.
- Pick a model and start chatting. Without credits, choose one whose ID ends in ":free".

Where does my OpenRouter key go?
On iPhone and Android, requests go straight from your device to the provider, and your key is kept in the phone’s secure storage (Keychain on iPhone, Keystore on Android). In the web app, requests go through a real-time pass-through on Oriveo’s server: your key is used only for that request and isn’t saved as an account record, and BYOK chats aren’t stored as chat logs. Keys aren’t uploaded by cloud sync. To use OpenRouter on a second device, paste the key there too, or create a separate key for it.
You pay OpenRouter directly at its prices. Oriveo adds no markup.
Why is my OpenRouter API key not working?
OpenRouter’s errors page (openrouter.ai/docs/api-reference/errors) lists what each code means. The common ones, as of 18 November 2026:
- In Oriveo, a 402 appears as "Provider Quota Reached", and a 429 as "Rate Limited" on the web or "Provider Rate Limited" on iPhone and Android.
- A model is missing from your list: sync the model list again and check that OpenRouter still offers it.
| Error | What it means | What to do |
|---|---|---|
| 401 Invalid credentials | The key is wrong, disabled or deleted | Copy the full key again, or create a new one |
| 401 "this is not an OpenRouter API key" | You pasted another provider’s key | Use a key from openrouter.ai/keys; it starts with sk-or-v1- |
| 402 insufficient credits | Your account or this key is out of credits | Add credits, or raise the key’s limit; waiting won’t help |
| 403 Forbidden | Blocked by permissions, moderation, a guardrail or a budget limit | Check the key’s settings and limits, or change your message |
| 429 rate limited | Too many requests, for OpenRouter or for the model’s provider | Wait and retry; with free models, check the limits above |
| 502 or 503 | The model or its providers are unavailable right now | Try again later or pick another model |
OpenRouter or a key from each provider?
OpenRouter is handy when you want many models with one key and one balance. A key straight from a provider such as OpenAI or Anthropic suits you when you want that provider’s own account and billing. Oriveo accepts both, so you can keep OpenRouter next to direct keys and switch models one after another in the same conversation.
Common app questions
Is OpenRouter free to use?
Where do I get my OpenRouter API key?
Does OpenRouter have an app for iPhone or Android?
What does OpenRouter error 402 mean?
Why is my OpenRouter API key not working?
What does an OpenRouter API key look like?
Related reads
From the blog
Use your OpenRouter key on your phone
Open the web app or download Oriveo for iPhone or Android, paste your OpenRouter key, and switch between models with an estimated cost on every reply.
No API key yet? Oriveo Free lets you start without one.