OpenRouter API: полное руководство
GPT, Claude, Gemini — один endpoint, 400+ моделей

Если ваш production stack дергает GPT, Claude, Gemini, Grok и open-weight models, вы уже знаете боль: пять vendor dashboards, пять billing cycles, пять SDK configs. OpenRouter схлопывает это в один OpenAI-compatible endpoint, один API key и 400+ models от 70+ providers. Этот разбор покрывает определение gateway, model vs provider routing, преимущества, матрицу OpenRouter vs direct API, pricing и BYOK, code samples, SEO для RU-локали, FAQ и MACNOX conversion bridge — с акцентом на routing mechanics, SDK drop-in и latency hop.

• TL;DR: base_url → https://openrouter.ai/api/v1, OpenAI SDK без переписывания, swap model slugs. Zero token markup — 5,5% credit fee (min $0.80).
• Free tier: 25+ free models, 50 req/day до покупки, 1 000/day после $10 top-up, cap 20 req/min.
• Best fit: prototypes, multi-model agents, fallback без пяти интеграций. Skip для enterprise SLA, custom fine-tunes, strict single-vendor residency.

SECTION 01 Multi-vendor LLM API: key sprawl, SDK fragmentation и outage blind spots

К середине 2026 большинство production AI stacks вызывают больше одной model family. Integration tax измерим:

• Key sprawl: OpenAI, Anthropic, Google, xAI, Moonshot — отдельные console, rate limits, auth headers. Credential rotation в CI/CD = security audit nightmare.
• SDK fragmentation: Anthropic Messages API ≠ OpenAI Chat Completions. Каждая model family требует adapter layer в agent framework.
• Outage blind spots: Provider down — fallback logic должна знать alternate model IDs, pricing и latency profiles заранее.
• Billing opacity: Per-token cost comparison требует spreadsheets. Оценка Kimi K3 vs Claude vs GPT часто стоит integration time, не list price.
• Metal/Core ML: Интеграция agent pipeline с Xcode и local tools требует native macOS host — VM дают overhead на Metal shaders и Core ML compile chain.

One-liner: OpenRouter — unified LLM API gateway — один key, endpoint https://openrouter.ai/api/v1, доступ к 70+ providers и 400+ models включая GPT-5.x, Claude 4.x, Gemini 2.x, Grok, DeepSeek, Kimi — с fallback и BYOK.

SECTION 02 Что такое OpenRouter? Dual routing, fallback, pricing и BYOK

OpenRouter — proxy layer между application и upstream LLM providers. Вы шлёте standard Chat Completions request; gateway выполняет provider selection, load balancing и aggregated billing.

Free models и rate limits

• До покупки credits: 50 free requests/day, не списываются с balance.
• После $10+ credits: 1 000 free requests/day.
• Rate cap: 20 requests/minute на free models.

SECTION 03 OpenRouter vs direct API: decision matrix и пять причин переключиться

Пять причин выбрать OpenRouter

1. One integration, every model: Swap model slugs — как при benchmark Grok 4.5 vs Claude.
2. OpenAI SDK compatibility: Меняете только base_url и api_key.
3. Automatic fallback: Claude → GPT → Gemini в одном request chain.
4. Transparent pricing: Catalog без hidden spread.
5. Free tier: 25+ free models до vendor contract.

Когда НЕ использовать OpenRouter

• Enterprise SLA и BAA: Healthcare/finance с signed vendor agreement.
• Custom fine-tuned endpoints: Private GPT-4 fine-tune отсутствует в public catalog.
• Strict data residency: Dedicated Anthropic capacity в EU region ≠ gateway routing.
• Ultra-low-latency: Gateway hop добавляет ms в real-time pipelines.
• High-volume negotiated rates: Six-figure monthly spend — direct с discount выигрывает.

SECTION 04 OpenRouter API code examples: curl, Python, OpenAI SDK, Node, streaming, fallback

Примеры используют OpenRouter base URL и dashboard API key. После upstream updates перепроверьте official docs.

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "HTTP-Referer: https://your-app.com" \
  -H "X-Title: Your App Name" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [{"role": "user", "content": "Explain model routing in one paragraph."}]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key="your_openrouter_api_key",
)

response = client.chat.completions.create(
    model="google/gemini-2.5-pro",
    messages=[{"role": "user", "content": "Compare GPT and Claude for code review."}],
)
print(response.choices[0].message.content)

const resp = await fetch("https://openrouter.ai/api/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.OPENROUTER_API_KEY}`,
    "Content-Type": "application/json",
    "HTTP-Referer": "https://your-app.com",
    "X-Title": "Your App Name",
  },
  body: JSON.stringify({
    model: "anthropic/claude-sonnet-4",
    messages: [{ role: "user", content: "Write a TypeScript retry helper." }],
  }),
});
const data = await resp.json();
console.log(data.choices[0].message.content);

from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key="your_openrouter_api_key",
)

stream = client.chat.completions.create(
    model="openai/gpt-4o",
    messages=[{"role": "user", "content": "Stream this response."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

{
  "models": [
    "anthropic/claude-sonnet-4",
    "openai/gpt-4o",
    "google/gemini-2.5-flash"
  ],
  "messages": [
    {"role": "user", "content": "Fallback on outage."}
  ]
}

SECTION 05 Setup OpenRouter: 6 шагов от sign-up до production fallback

1. Account и API key: Sign up на openrouter.ai, Settings → Keys, key в secrets manager.
2. Credits (optional для free tier upgrade): Minimum $10 для 1 000 free requests/day.
3. Client endpoint: base_url=https://openrouter.ai/api/v1 в OpenAI SDK.
4. Model slugs из catalog: Format vendor/model — openai/gpt-4o, moonshotai/kimi-k3.
5. Production fallback: models array с 2–3 alternates; log served model per request.
6. Attribution headers и monitoring: HTTP-Referer, X-Title; budget alerts до CI/CD; native macOS runner вместо VM для Metal/Core ML integration tests.

SECTION 06 Цитируемые параметры, RU SEO matrix и production takeaways

• Catalog scale: 70+ providers, 400+ models, endpoint https://openrouter.ai/api/v1.
• Free tier: 25+ free models; 50 req/day до purchase; 1 000/day после $10; 20 req/min.
• Revenue model: Zero token markup; 5,5% credit fee (min $0.80); BYOK 1M/month free.
• Routing: Model routing per slug; provider routing pins vendor; models arrays для fallback.
• SDK: OpenAI SDK drop-in — только base_url и api_key.

Верифицируемые источники — перепроверьте после релиза:

OpenRouter Official Documentation

OpenRouter FAQ — pricing, free models, BYOK

OpenRouter Models API — live catalog

RU keyword matrix

Schema и technical SEO

• Canonical: Каждая locale на себя — https://macnox.com/ru/blog/2026-openrouter-api-guide-gpt-claude-gemini.html.
• Schema: BlogPosting + nested FAQPage в mainEntity — FAQ text match visible <details>.
• Distribution RU: Habr, Telegram dev channels, Reddit r/LocalLLaMA — с working code blocks.

OpenRouter решает model access, но команды с multi-model API agents, macOS CI/CD и 24/7 test pipelines упираются в три gap: (1) gateway outage не заменяет sleeping local infra; (2) VM-based macOS CI несёт Metal/Core ML overhead; (3) developer MacBook не 24/7 agent host. Для zero hypervisor overhead, stable iOS/macOS CI/CD и AI Agent automation физические cloud-ноды MACNOX обычно оптимальнее: 100% Apple hardware, полный Root, гибкая аренда. См. Kimi K3 multi-vendor integration, Grok 4.5 agent cost analysis и аренда vs покупка Mac Mini M4.

SECTION 07 Часто задаваемые вопросы