OpenRouter API key: how to get one, set limits, and what to use if you can't top up
Where to create an OpenRouter key, which settings it has, what buying credits costs, and how free-model limits work. Plus an alternative if paying for credits is a problem.
7 min · · API keys · сравнение · payments
An OpenRouter API key is created on the Keys page of your OpenRouter account: you give the key a name and set a credit limit or choose no limit. The key is sent as a Bearer token, and with the OpenAI SDK you set base_url to https://openrouter.ai/api/v1. For users in some regions, including Russia, the hard part is not the key but paying for credits. If that doesn't work for you, the same code can point to a Zukko key: you change the base URL, the key, and the model names.
OpenRouter terms below are taken from its docs and pricing page, checked on 29.10.2026. They may change, so verify them before paying.
How to create an OpenRouter key
According to the authentication docs as of 29.10.2026:
- Sign in to OpenRouter.
- Open the Keys page.
- Name the key so you can tell which project or agent uses it.
- Set a credit limit or choose no limit.
- Store the key in an environment variable such as
OPENROUTER_API_KEY, not in source code.
Existing keys are managed in key settings.
Keys created during onboarding are a special case: they get a $100 limit and expire after 180 days. If a key from sign-up stops working a few months later, check its expiry first.
The key endpoint returns the remaining limit and the free-request counter (limits docs, as of 29.10.2026):
curl https://openrouter.ai/api/v1/key \
-H "Authorization: Bearer $OPENROUTER_API_KEY"A 401 response usually means the key was copied incompletely, deleted, or sent in the wrong header. Common causes are covered in the 401 Invalid API key article.
Limit, reset, and expiry
OpenRouter recommends setting a credit limit on every key. Without one, a leaked key or a runaway agent can spend the whole balance.
Per the API reference as of 29.10.2026, a key has:
- a credit limit;
- a limit reset: daily, weekly, or monthly, at midnight UTC;
- an expiry date.
Once a key hits its limit, requests are rejected until the limit is raised or resets. A practical setup is one key per project and per agent, each with a small limit and a regular reset.
What topping up costs: OpenRouter fees
According to the pricing page and FAQ as of 29.10.2026, models are sold at provider prices with no markup. The fee is charged when you buy credits:
- Standard plan: 5.5%, with a $0.80 minimum for card payments;
- Business plan: 8%.
On real amounts:
- $50 top-up on Standard: $50 × 0.055 = $2.75 fee;
- $10 top-up by card: $10 × 0.055 = $0.55, which is below the minimum, so the fee is $0.80.
Other terms worth knowing before paying:
- payment methods: bank cards, AliPay, and USDC;
- crypto payments are non-refundable;
- unused credits can be refunded only within 24 hours, and the fee is not refunded;
- under the terms of service as of 29.10.2026, OpenRouter may expire unused credits 365 days after purchase.
If you have your own provider keys, BYOK mode gives up to $25,000 of inference per month with no fee and 5% above that (per the FAQ, as of 29.10.2026).
Free model limits
Models with the :free suffix come with limits (per the limits docs as of 29.10.2026):
| Condition | Limit |
|---|---|
| Any account | 20 requests per minute |
| Fewer than 10 credits purchased in total | 50 requests per day |
| 10 or more credits purchased | 1000 requests per day |
Failed requests count too. Extra accounts and keys don't raise the limits, since OpenRouter counts them globally.
Why topping up can be hard from some regions
The main obstacle is payment. OpenRouter accepts bank cards, AliPay, and USDC, and cards issued in some countries, Russia among them, are generally declined by foreign services. That leaves crypto or intermediaries, each with its own costs and risks. Options are covered in paying for OpenRouter from Russia.
There's also a policy point: some providers block users from certain countries from their models, and bypassing that through OpenRouter is prohibited. The service is for users aged 18 and over.
Alternative: a Zukko key
Zukko is an LLM API gateway with an OpenAI-compatible endpoint. Keys look like fetch_... and are created in the dashboard under API keys.
Per-key limits
A Zukko key can have:
- a daily spend limit in dollars;
- a monthly spend limit in dollars;
- a list of allowed models.
When a limit is reached, the request gets a 429 with code key_daily_limit_reached or key_monthly_limit_reached. With a zero balance you get a 402, so the client can tell a key limit apart from an empty account.
Payment
The balance is in dollars, you pay only for tokens used, and there is no subscription fee. Top-ups start at $1:
| Method | Terms |
|---|---|
| SBP (Russian fast payments) | in rubles at the market rate, the payment page adds about 8.5% |
| Crypto | no added fee |
| Foreign MasterCard | $2 to $594 per payment, about 13% added |
A $10 top-up via SBP: $10 × 0.085 = $0.85 added, so $10 + $0.85 = $10.85 total. That's an estimate, since the markup is stated as about 8.5%. Details are in the docs.
There's no free tier or sign-up bonus. You get $0.50 once for subscribing to the @zukkopro Telegram channel.
Cost example: claude-sonnet-5 is $0.4 per 1M input and $2 per 1M output tokens. A job with 2M input and 0.5M output tokens costs 2 × $0.4 + 0.5 × $2 = $0.8 + $1 = $1.80. The current model list with prices is at GET https://api.zukko.pro/v1/models.
Moving code from OpenRouter to Zukko
Three things change:
- base_url:
https://openrouter.ai/api/v1becomeshttps://api.zukko.pro/v1; - the OpenRouter key becomes a
fetch_...key; - model names: Zukko ids have no vendor prefix, for example
claude-sonnet-5.
import os
from openai import OpenAI
# Before: OpenRouter
# client = OpenAI(
# base_url="https://openrouter.ai/api/v1",
# api_key=os.environ["OPENROUTER_API_KEY"],
# )
# After: Zukko
client = OpenAI(
base_url="https://api.zukko.pro/v1",
api_key=os.environ["ZUKKO_API_KEY"], # key like fetch_...
)
response = client.chat.completions.create(
model="claude-sonnet-5", # id without vendor prefix
messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)List available ids:
curl https://api.zukko.pro/v1/models \
-H "Authorization: Bearer $ZUKKO_API_KEY"Cursor, Codex, and opencode work the same way: base URL https://api.zukko.pro/v1, fetch_... key in the API key field.
Claude Code and the Anthropic SDK use different variables:
export ANTHROPIC_BASE_URL=https://api.zukko.pro
export ANTHROPIC_AUTH_TOKEN=fetch_...Here the base URL has no /v1; the client adds the path. Don't use ANTHROPIC_API_KEY: with it, Claude Code asks you to sign in to an Anthropic account. See ANTHROPIC_API_KEY vs ANTHROPIC_AUTH_TOKEN for the difference, and moving from OpenRouter for the full list of code and config changes.
OpenRouter and Zukko keys compared
OpenRouter data as of 29.10.2026.
| OpenRouter | Zukko | |
|---|---|---|
| Where to create | Keys page in your account | Dashboard, API keys section |
| Key controls | credit limit, daily/weekly/monthly reset, expiry date | daily and monthly dollar limits, allowed models list |
| Limit reached | requests rejected | 429 with a limit code |
| Base URL for OpenAI SDK | https://openrouter.ai/api/v1 | https://api.zukko.pro/v1 |
| Model ids | with vendor prefix | no prefix, e.g. claude-sonnet-5 |
| Fees | 5.5% on Standard ($0.80 minimum by card), 8% on Business | SBP about 8.5%, crypto none, MasterCard about 13% |
| Payment methods | cards, AliPay, USDC | SBP, crypto, foreign MasterCard |
| Free access | :free models with daily limits | no free tier, one-time $0.50 for a channel subscription |
More on the differences in Zukko vs OpenRouter.
FAQ
Can I use an OpenRouter key without buying credits?
Yes, for :free models. The limit is 20 requests per minute and 50 per day while you've bought fewer than 10 credits in total (as of 29.10.2026). Failed requests count too.
Why did my OpenRouter key stop accepting requests?
Common causes: the key's credit limit is used up, the key expired (onboarding keys last 180 days), or the daily free-model limit ran out. GET https://openrouter.ai/api/v1/key shows the remaining limit and free-request counter.
Will a Zukko key work with code written for OpenRouter?
Yes, if the code uses the OpenAI SDK or an OpenAI-compatible format. Replace the base URL, the key, and the model names with ids from https://api.zukko.pro/v1/models.
Does Zukko have free models or a trial balance?
No. There's no free tier or sign-up bonus; you get $0.50 once for subscribing to the @zukkopro Telegram channel. Top-ups start at $1.
How do I cap spending on a Zukko key?
Set daily and monthly dollar limits on the key and, if needed, a list of allowed models. Once a limit is hit, requests get a 429 until it resets or is raised. Setup questions go to support.
zukko
Pay 25×
less
for Claude Code & ChatGPT
One fetch_* key and base URL api.zukko.pro — for Cursor, Claude Code, Codex, and any SDK.
Related articles
- Claude Pro and Max subscription from Russia: can you get one and what to use insteadClaude Pro is $20 a month and Max is $100 or $200, but you can't subscribe from Russia. What a plan includes, the risks of workarounds, and what the same work costs per token.
- AI Model API Aggregator: Claude, GPT, Gemini and DeepSeek on One KeyAn aggregator gives you one key and one balance for models from several vendors. Here is how an OpenAI-compatible API works, what models cost directly versus through a gateway, and what to check before you choose.
- DeepSeek API key: how to get one and which base_url to useTwo ways to a DeepSeek key: the official platform and the Zukko gateway. API addresses, model names, checking the key and common connection errors.
- Gemini API key: how to get one and what to do if it does not workTwo ways to a Gemini API key: a Google AI Studio key and a Zukko gateway key. Steps, request examples, safe storage and common problems.
- GLM API key: how to get a key for GLM 5.3 and which URL to useA GLM key can come from the Z.ai platform or from a gateway. We show both routes, the correct addresses, model ids and a cost comparison on an example.
- Buying an AI API key: what you actually buy and what you riskListings that say "buy a ChatGPT API key" sell different things. We explain the difference between someone else's key and your own key with a balance, and give a checklist.