OpenRouter: как пользоваться единым API моделей

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 и тарифы сверяйте в каталоге на дату запуска; рублевый прайс в статье не фиксируем.

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

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