OpenRouter API key guide

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.

Updated
  • 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.
Oriveo on iPhone: the providers screen, listing the providers you connected and this month’s spend.

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.
Is the OpenRouter API free?
Your accountFree-model requests per minuteFree-model requests per day
Bought fewer than 10 credits in total2050
Bought at least 10 credits in total201,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".
Oriveo home screen with a message box, the selected model shown below it, and today’s chats each with a cost
After you connect a key, choose a model under the message box. Each chat in the list shows its estimated cost.

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.
Why is my OpenRouter API key not working?
ErrorWhat it meansWhat to do
401 Invalid credentialsThe key is wrong, disabled or deletedCopy the full key again, or create a new one
401 "this is not an OpenRouter API key"You pasted another provider’s keyUse a key from openrouter.ai/keys; it starts with sk-or-v1-
402 insufficient creditsYour account or this key is out of creditsAdd credits, or raise the key’s limit; waiting won’t help
403 ForbiddenBlocked by permissions, moderation, a guardrail or a budget limitCheck the key’s settings and limits, or change your message
429 rate limitedToo many requests, for OpenRouter or for the model’s providerWait and retry; with free models, check the limits above
502 or 503The model or its providers are unavailable right nowTry 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?
Partly. The key is free, and models whose IDs end in ":free" cost nothing within daily limits: as of 18 November 2026, 50 requests a day, or 1,000 once you have bought at least 10 credits. Other models need prepaid credits.
Where do I get my OpenRouter API key?
At openrouter.ai/keys after you sign in. Create a key, give it a name and copy all of it; it starts with "sk-or-v1-".
Does OpenRouter have an app for iPhone or Android?
OpenRouter doesn’t publish its own mobile chat app. Use a chat app that accepts an OpenRouter key: in Oriveo, open Providers, tap +, choose OpenRouter, paste the key and tap Continue.
What does OpenRouter error 402 mean?
Your account or the key you’re using doesn’t have enough credits. Add credits on OpenRouter, or raise the key’s limit if you set one, then try again. It won’t clear on its own.
Why is my OpenRouter API key not working?
Check the error number. 401 means the key is wrong or isn’t an OpenRouter key; 402 means no credits; 429 means too many requests or the free-model limit. Our API key errors guide covers each code.
What does an OpenRouter API key look like?
It starts with "sk-or-v1-" followed by 64 letters and digits, 73 characters in total. If yours is shorter, part of it didn’t copy.

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.