OpenRouter: один ключ API для 300+ моделей ИИ (аккаунт, API, OpenCode, VS Code)

Введение

OpenRouter — это шлюз к 300+ моделям ИИ через один ключ API и один счёт. Вместо регистрации у каждого провайдера вы регистрируетесь один раз, пополняете баланс и вызываете любую модель через API, совместимый с OpenAI: флагманские коммерческие модели, дешёвые быстрые модели, открытые модели и бесплатные модели для экспериментов.

На этом сайте у него два типичных применения: источник моделей для агента для программирования OpenCode (один ключ OpenRouter заменяет целый карман ключей разных провайдеров) и облачная альтернатива локальному запуску Qwen, когда нужно качество выше, чем может дать ваше железо.

Создание аккаунта

  1. Откройте openrouter.ai и зарегистрируйтесь (подойдёт вход через Google или GitHub, а также обычная почта).
  2. Бесплатные модели работают уже с аккаунтом — для старта платить не нужно.
  3. Платным моделям нужен пополненный баланс: откройте страницу кредитов и оплаты и пополните счёт картой. Оплата по факту использования, за миллион токенов; точные цены стоят рядом с каждой моделью на странице моделей и меняются, поэтому смотрите их там, а не в статьях в блогах.

Создание ключа API

  1. Откройте openrouter.ai/settings/keys и создайте ключ. Он начинается с sk-or- — скопируйте его сразу, он показывается один раз.
  2. Положите ключ в переменную окружения, а не вставляйте его в файлы:

export OPENROUTER_API_KEY="sk-or-your-key-here"

Относитесь к ключу как к паролю: никогда не коммитьте его в git, не вставляйте в чаты и скриншоты. Если ключ утёк, удалите его на странице ключей и создайте новый.

Знакомство с моделями на сайте

Прежде чем что-то подключать, попробуйте модель в браузере:

  1. Откройте openrouter.ai/models: у каждой модели видны цена за миллион токенов, длина контекста и есть ли у неё бесплатный вариант (бесплатные варианты заканчиваются на :free).
  2. Откройте модель и в окне чата задайте несколько вопросов из своей предметной области — это самый дешёвый способ сравнить качество, прежде чем тратить кредиты в цикле агента.
  3. Скопируйте точный идентификатор модели (формат провайдер/модель, например openai/gpt-4o) — он понадобится дословно в коде и конфигах ниже.

Вызов моделей из кода

Эндпоинт API — https://openrouter.ai/api/v1, он говорит на формате чата OpenAI. Минимальный запрос через curl:

curl https://openrouter.ai/api/v1/chat/completions -H "Content-Type: application/json" -H "Authorization: Bearer $OPENROUTER_API_KEY" -d '{"model": "openai/gpt-4o", "messages": [{"role": "user", "content": "Hi"}]}'

Тот же вызов на Python (нужен пакет openai):

pip install openai

import os from openai import OpenAI client = OpenAI( base_url="https://openrouter.ai/api/v1", api_key=os.environ["OPENROUTER_API_KEY"], ) answer = client.chat.completions.create( model="openai/gpt-4o", messages=[{"role": "user", "content": "Say hi"}], ) print(answer.choices[0].message.content)

OpenRouter в OpenCode

Полная настройка агента живёт в статье OpenCode: скачать, установить и применять — здесь только часть про OpenRouter:

  1. Запустите OpenCode (opencode) и введите /connect.
  2. Выберите провайдера OpenRouter и вставьте свой ключ (тот самый sk-or- из шага выше).
  3. Введите /models, чтобы увидеть список доступных вам идентификаторов моделей, и закрепите модель по умолчанию в opencode.json с точным идентификатором из этого списка.

OpenRouter в VS Code

Подойдёт любое расширение ИИ для VS Code, которое принимает своего провайдера; три распространённых:

models: - name: OpenRouter GPT-4o provider: openrouter model: openai/gpt-4o apiKey: YOUR_OPENROUTER_KEY

Где расширение это поддерживает, предпочитайте переменную окружения захардкоженному ключу, а актуальные названия полей сверяйте в документации расширения.

Ключи, лимиты и приватность

Что делать при сбоях

Официальные источники:

Автор статьи: Клавдия Кондакова