OpenRouter API: GPT, Claude & Gemini через один ключ — полный гайд (2026)
Кому и зачем? Mac-разработчикам и AI-инженерам, которым нужен единый endpoint для GPT/Claude/Gemini в Cursor, OpenClaw или своих агентах — без зоопарка ключей и SDK. Что внутри: матрица model/provider routing, таблица OpenRouter vs прямой API, 7 шагов получения ключа, curl/Python/streaming/fallback, тарифная сетка 5,5% + BYOK. Структура: 3 цифры для гиков, FAQ×6, чеклист валидации, посуточная аренда Mac под изолированные API-тесты.
Оглавление
Ещё по теме: недельный рейтинг токенов, CLI-инструменты, тренды LLM и выбор агента.
Короткий ответ
OpenRouter = unified LLM gateway. Один OPENROUTER_API_KEY, endpoint https://openrouter.ai/api/v1/chat/completions (Bearer, OpenAI Chat Completions wire format), 400+ models от 70+ vendors. Меняешь только model: openai/gpt-4o → anthropic/claude-3.5-sonnet → google/gemini-2.5-pro. OpenAI SDK: swap base_url + api_key — profit.
01 · TL;DR и метрики
- Wire protocol: OpenAI-compatible chat/completions — минимальный diff при миграции.
- Routing stack:
model(какая LLM) +provider(какой upstream host) + optionalroute: fallback. - Billing: token price = list price провайдера; platform fee только на credit purchase (5,5%) или BYOK overage.
- Free tier: 25+ models, ~50 req/day без credits, 1000/day после $10 top-up, cap 20 req/min.
Цифра #1: публичный leaderboard — 28+ трлн tokens за rolling 7 days. Это prod agent traffic, не playground.
Цифра #2: gateway hop добавляет 10–80 ms — мерь TTFT до commit на latency-critical стеках.
Цифра #3: ~1M tokens/month Claude Sonnet → credit fee порядка $4–8 — дешевле трёх интеграций, дороже direct contract на $50k+/mo.
02 · Матрица роутинга: Model vs Provider
| Слой | Решение | Поле API |
|---|---|---|
| Model routing | Какая модель отвечает | model / openrouter/auto |
| Provider routing | Какой upstream обслуживает ту же модель | provider — price-weighted по умолчанию |
| Fallback HA | Auto-switch на 429/5xx | models[] + "route": "fallback" |
| Free models | 25+ zero-cost endpoints | 50/day → 1000/day после $10 credits; 20/min |
03 · OpenRouter vs прямой API (OpenAI / Anthropic / Google)
| Параметр | OpenRouter | Direct API |
|---|---|---|
| API keys | 1 key → 400+ models | Account + key per vendor |
| SDK migration | Drop-in: base_url swap | Native SDKs / adapters |
| Token pricing | List price, zero markup | List price |
| Platform fee | 5,5% credit buy (min $0.80) | No gateway fee |
| Failover | Built-in provider + model fallback | Roll your own retries |
| Vendor-only APIs | Subset (no Batch/Assistants first-class) | Prompt cache billing, Vertex tools, etc. |
| Latency | +10–80 ms hop | Direct to provider region |
| Sweet spot | Multi-model, prototyping, <~$10k/mo | Single-model scale, compliance, <50 ms SLA |
04 · Пять причин переключиться — и anti-patterns
- One key to rule them all — vendor switch = одна строка
model. - Failover без circuit breaker в коде — gateway жрёт 429 за вас.
- Unified dashboard — tokens, $, TTFT, model mix в одном UI.
- No token markup — платформа зарабатывает на credits/BYOK, не на per-token spread.
- Free models для CI smoke — перед burn на frontier models.
Когда OpenRouter — плохая идея
- Hyperscale single-model — 5,5% credits > enterprise direct contract.
- Нужны OpenAI Batch, Anthropic prompt-cache optimizations, Vertex-only tooling.
- Data residency запрещает US third-party gateway (если BYOK не проходит legal).
- Sub-50 ms inference SLA — лишний hop ломает requirement.
Честный блок «когда не использовать» — это не минус SEO, а фильтр qualified traffic. Гики это ценят.
05 · 7 шагов: получить OpenRouter API key
- Регистрация на openrouter.ai (GitHub/Google SSO).
- Dashboard → Keys → Create Key; naming:
dev-mac-sandbox, неprod-laptop. - Credit limit на key при shared billing.
- Export:
export OPENROUTER_API_KEY="sk-or-..."— не коммить в git, не класть в dotfiles на shared machine. - Top-up optional ($10 min → higher free quotas); crypto +5% processing.
- Smoke test curl (секция 06) до wiring в Cursor/LangChain/OpenClaw.
- BYOK optional: upstream keys в Settings — first 1M routed req/month fee-free.
06 · Примеры кода
6.1 cURL
curl https://openrouter.ai/api/v1/chat/completions \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "anthropic/claude-3.5-sonnet",
"messages": [
{ "role": "user", "content": "Объясни квантовые вычисления одним предложением." }
]
}'6.2 Python — OpenAI SDK drop-in
import os
from openai import OpenAI
client = OpenAI(
base_url="https://openrouter.ai/api/v1",
api_key=os.environ["OPENROUTER_API_KEY"],
)
r = client.chat.completions.create(
model="deepseek/deepseek-chat",
messages=[{"role": "user", "content": "Hello from OpenRouter"}],
)
print(r.choices[0].message.content)6.3 Fallback chain JSON
{
"model": "anthropic/claude-3.5-sonnet",
"models": [
"anthropic/claude-3.5-sonnet",
"openai/gpt-4o",
"google/gemini-2.5-pro"
],
"route": "fallback",
"messages": [{ "role": "user", "content": "ping" }]
}6.4 Streaming
stream = client.chat.completions.create(
model="openai/gpt-4o",
messages=[{"role": "user", "content": "Haiku about autumn"}],
stream=True,
)
for chunk in stream:
delta = chunk.choices[0].delta.content
if delta:
print(delta, end="", flush=True)Pro tip: model IDs строго vendor/model — gpt-4o без openai/ → 404. Pull live catalog: GET /api/v1/models.
07 · Тарифная матрица
| Fee type | Rate | Notes |
|---|---|---|
| Paid model tokens | Provider list price | Zero OpenRouter markup |
| Credit purchase | 5,5% (min $0.80) | Charged on top-up |
| Crypto payment | +5% | On top of credit fee |
| BYOK routing | Free first 1M req/mo | Then 5% equivalent |
| Free models | $0 tokens | ~50 req/day; 1000/day after $10 |
08 · Чеклист валидации (5 шагов на изолированном Mac)
- Disposable key на арендованном Mac — curl три model ID (GPT, Claude, Gemini).
- OpenAI SDK →
base_url=https://openrouter.ai/api/v1; сверить response schema. stream=True— TTFT vs direct baseline на одном prompt set.- POST fallback JSON; trigger failure — chain должен отработать.
- CSV: latency, tokens, $; revoke key; wipe env перед return machine.
09 · FAQ×6
Q: Что такое OpenRouter?
A: Unified LLM gateway — один key, OpenAI-compatible endpoint, 70+ vendors, 400+ models.
Q: Markup на tokens?
A: Нет. 5,5% на credit purchase (min $0.80) или 5% BYOK >1M req/mo.
Q: OpenRouter vs direct OpenAI — что выбрать?
A: Multi-model + failover under moderate spend → OpenRouter. Hyperscale/compliance → direct.
Q: OpenAI Python SDK работает?
A: Да — swap base_url + key, model как vendor/model.
Q: Fallback routing?
A: models array + "route": "fallback" — sequential retry без client code.
Q: Production-safe?
A: Да, если keys scoped, rotated, tested on isolated hardware; BYOK для compliance.
10 · Посуточная аренда Mac для изолированных OpenRouter-тестов
curl на Linux VPS — ок для smoke test. Реальный стек Mac-команды — Cursor BYOK, OpenClaw gateway, Keychain-scoped credentials. A/B GPT/Claude/Gemini на daily driver утекает в .zshrc, смешивает cache dirs, оставляет fallback configs.
Windows cloud не воспроизводит Keychain isolation; Linux VPS — нет native IDE agents. Посуточная аренда Apple Silicon = rhythm «create key → benchmark → revoke → destroy node». Тарифы: MacDate pricing, также аренда vs покупка Mac mini.
11 · Источники
Обновлено: 24 июля 2026 | Pricing per OpenRouter docs на дату публикации