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:

  1. Sign in to OpenRouter.
  2. Open the Keys page.
  3. Name the key so you can tell which project or agent uses it.
  4. Set a credit limit or choose no limit.
  5. 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):

bash
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):

ConditionLimit
Any account20 requests per minute
Fewer than 10 credits purchased in total50 requests per day
10 or more credits purchased1000 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:

MethodTerms
SBP (Russian fast payments)in rubles at the market rate, the payment page adds about 8.5%
Cryptono 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:

  1. base_url: https://openrouter.ai/api/v1 becomes https://api.zukko.pro/v1;
  2. the OpenRouter key becomes a fetch_... key;
  3. model names: Zukko ids have no vendor prefix, for example claude-sonnet-5.
bash
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:

bash
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:

bash
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.

OpenRouterZukko
Where to createKeys page in your accountDashboard, API keys section
Key controlscredit limit, daily/weekly/monthly reset, expiry datedaily and monthly dollar limits, allowed models list
Limit reachedrequests rejected429 with a limit code
Base URL for OpenAI SDKhttps://openrouter.ai/api/v1https://api.zukko.pro/v1
Model idswith vendor prefixno prefix, e.g. claude-sonnet-5
Fees5.5% on Standard ($0.80 minimum by card), 8% on BusinessSBP about 8.5%, crypto none, MasterCard about 13%
Payment methodscards, AliPay, USDCSBP, crypto, foreign MasterCard
Free access:free models with daily limitsno 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.

Get API keyDocumentation

api.zukko.pro · fetch_*

OpenRouter API Key: How to Get One and Alternatives · Zukko