OpenRouter API Один ключ 400+ моделей 2026-07-24

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-тесты.

OpenRouter unified API gateway: один ключ роутит запросы к GPT Claude Gemini и 400 плюс LLM моделям

Ещё по теме: недельный рейтинг токенов, 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-4oanthropic/claude-3.5-sonnetgoogle/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) + optional route: 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 HAAuto-switch на 429/5xxmodels[] + "route": "fallback"
Free models25+ zero-cost endpoints50/day → 1000/day после $10 credits; 20/min

03 · OpenRouter vs прямой API (OpenAI / Anthropic / Google)

Параметр OpenRouter Direct API
API keys1 key → 400+ modelsAccount + key per vendor
SDK migrationDrop-in: base_url swapNative SDKs / adapters
Token pricingList price, zero markupList price
Platform fee5,5% credit buy (min $0.80)No gateway fee
FailoverBuilt-in provider + model fallbackRoll your own retries
Vendor-only APIsSubset (no Batch/Assistants first-class)Prompt cache billing, Vertex tools, etc.
Latency+10–80 ms hopDirect to provider region
Sweet spotMulti-model, prototyping, <~$10k/moSingle-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

  1. Регистрация на openrouter.ai (GitHub/Google SSO).
  2. Dashboard → Keys → Create Key; naming: dev-mac-sandbox, не prod-laptop.
  3. Credit limit на key при shared billing.
  4. Export: export OPENROUTER_API_KEY="sk-or-..." — не коммить в git, не класть в dotfiles на shared machine.
  5. Top-up optional ($10 min → higher free quotas); crypto +5% processing.
  6. Smoke test curl (секция 06) до wiring в Cursor/LangChain/OpenClaw.
  7. 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/modelgpt-4o без openai/ → 404. Pull live catalog: GET /api/v1/models.

07 · Тарифная матрица

Fee type Rate Notes
Paid model tokensProvider list priceZero OpenRouter markup
Credit purchase5,5% (min $0.80)Charged on top-up
Crypto payment+5%On top of credit fee
BYOK routingFree first 1M req/moThen 5% equivalent
Free models$0 tokens~50 req/day; 1000/day after $10

08 · Чеклист валидации (5 шагов на изолированном Mac)

  1. Disposable key на арендованном Mac — curl три model ID (GPT, Claude, Gemini).
  2. OpenAI SDK → base_url=https://openrouter.ai/api/v1; сверить response schema.
  3. stream=True — TTFT vs direct baseline на одном prompt set.
  4. POST fallback JSON; trigger failure — chain должен отработать.
  5. 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 на дату публикации