OpenRouter — это единый API к сотням AI-моделей: ключ OPENROUTER_API_KEY, endpoint https://openrouter.ai/api/v1 и вызов chat.completions с model id вида vendor/model. Фокус-ключ: openrouter. Канон: Quickstart и Models. Соседи: LiteLLM, OpenAI API, Together AI, ИИ-автоматизация.

Ниже — маршрут новичка: ключ → OpenAI SDK или HTTP → один рабочий chat completion. Model id и тарифы сверяйте в каталоге на дату запуска; рублевый прайс в статье не фиксируем.

Три пути интеграции

Путь Когда Старт Endpoint / SDK
HTTP API любой язык, полный контроль Bearer + JSON POST /api/v1/chat/completions
OpenAI SDK уже есть код на openai base_url OpenRouter https://openrouter.ai/api/v1
Client SDK type-safe клиент pip install openrouter / @openrouter/sdk см. Client SDKs в доке
Agent SDK агент с tools и циклами @openrouter/agent callModel + tools
Models API выбор модели программно GET /api/v1/models фильтры modalities / sort

Источник: openrouter.ai/docs/quickstart, docs/guides/overview/models, docs/guides/community/openai-sdk. Сверка: 2026-10-10. Цены в USD на карточке модели; ₽ не выдумываем.

Первый вызов на Python

  1. Создайте API Key в кабинете OpenRouter и экспортируйте: export OPENROUTER_API_KEY=….
  2. Поставьте клиент: pip install openai (или официальный pip install openrouter).
  3. Укажите base_url="https://openrouter.ai/api/v1" и model id из каталога.
  4. Опционально передайте заголовки HTTP-Referer и X-OpenRouter-Title для атрибуции приложения.
  5. Для прода сверяйте pricing на карточке модели, rate limits и fallback через параметр models (список запасных id).
export OPENROUTER_API_KEY="your_api_key_here"
pip install openai

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key=os.environ["OPENROUTER_API_KEY"],
)

completion = client.chat.completions.create(
    extra_headers={
        "HTTP-Referer": "https://example.com",  # optional
        "X-OpenRouter-Title": "My App",          # optional
    },
    model="openai/gpt-4o",  # сверяйте openrouter.ai/models на дату запуска
    messages=[{"role": "user", "content": "Объясни за 3 пункта, зачем единый LLM API"}],
)
print(completion.choices[0].message.content)

Альтернатива без SDK: POST https://openrouter.ai/api/v1/chat/completions с заголовком Authorization: Bearer $OPENROUTER_API_KEY. Список slug — через GET /api/v1/models. Ключ держите в env, не в репозитории.

Типичные ошибки

  • Копировать устаревший model id из чужого туториала вместо актуального каталога.
  • Путать прямой OpenAI endpoint и openrouter.ai/api/v1 — разный биллинг и каталог.
  • Фиксировать рублевый прайс токенов в статье — смотрите USD на карточке модели.
  • Коммитить OPENROUTER_API_KEY в git или в публичный фронтенд.
  • Игнорировать fallback: один провайдер может отвалиться, OpenRouter умеет список запасных моделей.

FAQ: OpenRouter

Что такое OpenRouter простыми словами?

OpenRouter — это единый API к сотням моделей разных провайдеров: один ключ OPENROUTER_API_KEY, endpoint https://openrouter.ai/api/v1/chat/completions и model id вида vendor/model. Канон: openrouter.ai/docs/quickstart.

Какой base_url ставить в OpenAI SDK?

base_url=»https://openrouter.ai/api/v1″ и api_key из OPENROUTER_API_KEY. Опционально HTTP-Referer и X-OpenRouter-Title для атрибуции приложения в рейтингах OpenRouter.

Какой model id брать для первого вызова?

Берите актуальный slug из openrouter.ai/models или GET /api/v1/models. В официальных примерах встречаются openai/gpt-4o и openai/gpt-4; каталог обновляется — перед продом сверяйте id.

Чем OpenRouter отличается от прямого OpenAI или Anthropic API?

Прямой API — один вендор и его биллинг. OpenRouter маршрутизирует запросы по каталогу провайдеров, умеет fallback и единый счёт. Соседи: /openai-api-kak-polzovatsya/, /anthropic-api-kak-polzovatsya/, /litellm-kak-polzovatsya/.

Можно ли звать OpenRouter через LiteLLM?

Да, когда нужен единый gateway на несколько бэкендов. Для одного скрипта достаточно OpenAI-клиента с base_url OpenRouter. Соседний лонгрид: LiteLLM.

Есть ли цены в рублях в статье?

Нет. Цены смотрите в openrouter.ai/models и своём биллинге (USD за токены). Рубли и курс — в кабинете/посреднике, не фиксируем в тексте.

Вывод

OpenRouter — ключ в env, OpenAI-совместимый base_url, один chat completion на актуальном model id из каталога. Старт: Quickstart → свой скрипт → сверка Models API и pricing. Когда нужна система обучения под интеграции — форматы на странице обучения.

Артём Денисов — эксперт Нетологии и автор курса Яндекс Практикума по промпт-инжинирингу. Сверяет OpenRouter с официальной докой на дату публикации.

Хотите нейросети под свои задачи, а не «для всех»?

Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артёма Денисова — все форматы на странице обучения. Соседи по стеку — ИИ-автоматизация и LiteLLM.