Собери один маршрут
OpenRouter даёт один API-ключ к каталогу разных моделей. Путь короткий: создать ключ, найти free-модель, отправить первый запрос, сравнить две модели и поставить ограничение, чтобы fallback не вырос в неожиданный счёт.
Ошибка, которую я бы убрал сразу: Создать ключ, выбрать openrouter/free и сразу отправить рабочие документы. Free удобен для проверки формата, но данные всё равно уходят внешнему провайдеру.
Что нужно до старта
- Одна задача и одна обезличенная выборка для сравнения.
- Обычный API-ключ OpenRouter, сохранённый сразу после создания.
- Актуальный model ID из каталога или Models API.
- Короткий запрос через /api/v1/chat/completions.
- Лимит на ключе и понятный dev-проект.
- Разрешённый порядок fallback-моделей и правило остановки.
- Лог конечной модели, статуса, usage и стоимости.
Как получить ключ и выбрать модель
- Опиши задачу одним предложением
Запиши, что должно получиться: короткая выжимка, JSON из заявки или перевод пяти строк. Добавь один пример хорошего результата и один пример ошибки. Вопрос «какая модель самая умная» на этом шаге не помогает.
Что увидишь: Один и тот же вход можно отправить двум моделям и сравнить по одинаковым правилам.
Если не сработало: Сократи задачу до одного действия. Каталог не заменит критерий, которого нет на входе.
- Создай обычный API-ключ
Зарегистрируйся на openrouter.ai, открой Keys и создай ключ для dev-теста. Management key для управления ключами в запрос к модели не подставляй: это отдельный тип доступа.
export OPENROUTER_API_KEY="sk-or-v1-REPLACE_ME"Что увидишь: Есть отдельный ключ для теста, понятен проект и установлен небольшой лимит.
Если не сработало: Проверь, какой ключ создал, и сохрани точный код ответа. Новый ключ не исправит перепутанный тип доступа.
- Найди актуальную модель
Открой Models или запроси /api/v1/models. Смотри на model ID, контекст, поддерживаемые параметры и цену. ID из старого поста не копируй: каталог и цены меняются.
Что увидишь: Две модели для одинакового теста и дата, на которую проверил их условия.
Если не сработало: Убери третью модель. Сначала выясни, какой параметр или цена мешает сравнению.
- Проверь free-маршрут
Для первого запроса можно использовать официальный Free Models Router с model: openrouter/free. Он выберет доступную бесплатную модель, поэтому результат может меняться. Здесь проверяешь ключ, endpoint и обработку ответа.
curl https://openrouter.ai/api/v1/chat/completions -H "Authorization: Bearer $OPENROUTER_API_KEY" -H "Content-Type: application/json" -d '{"model":"openrouter/free","messages":[{"role":"user","content":"Ответь одним предложением: API работает?"}],"max_tokens":64}'Что увидишь: Запрос проходит, в ответе есть текст и информация о фактически использованной модели.
Если не сработало: 401 — ключ; 402 — оплата или баланс; 429 — лимит; 5xx — временная ошибка. Разбирай их отдельно.
- Сравни две модели на одной выборке
Отправь один и тот же вход двум model ID. Запиши качество, задержку, usage, цену и количество ручных исправлений. Один prompt одной модели ничего не доказывает.
Что увидишь: Короткая таблица: модель, цена, скорость, ошибки, качество и подходящий класс задач.
Если не сработало: Не меняй prompt во время сравнения. Сначала повтори тест с теми же входом и ограничениями.
- Настрой fallback только после сравнения
Fallback нужен, когда первая модель недоступна, упёрлась в rate limit или вернула ошибку. Задай короткий список запасных моделей и проверь, можно ли передавать им тот же тип данных.
Что увидишь: В логе видны выбранная и конечная модель, статус, usage и стоимость. Процесс останавливается, если лимит исчерпан.
Если не сработало: Отключи автоматическое переключение и оставь ручной выбор, пока не станет понятно, куда уходит запрос и сколько он стоит.
Что такое OpenRouter
OpenRouter — посредник между приложением и моделями разных провайдеров. Endpoint один, model ID меняется внутри запроса. Можно сравнить несколько вариантов, не переписывая клиент.
Дальше — данные и деньги. Проверь, какой провайдер получит запрос, как считается цена и что случится при недоступности выбранной модели.
- Один ключ не делает модели одинаковыми.
- Проверяй маршрут до передачи рабочих данных.
Где у OpenRouter бесплатные модели
В каталоге есть free-модели (часто с суффиксом `:free`) и Free Models Router `openrouter/free`. По официальным FAQ и Limits (проверено 2026-08-08): free-варианты — 20 RPM; 50 RPD, если за всё время куплено меньше 10 credits; 1000 RPD после покупки минимум 10 credits. RPM при этом остаётся 20.
При покупке credits OpenRouter берёт fee (в FAQ: Stripe ~5.5% с минимумом $0.80; crypto ~5%). Inference markup на провайдера нет. `GET https://openrouter.ai/api/v1/key` показывает balance/limit ключа. Free tier годится для smoke-test, не для production SLA.
- Сохраняй дату проверки лимита.
- Не отправляй чувствительные документы без проверки условий.
- Платный variant той же модели не эквивалентен `:free` по лимитам.
Fallback меняет модель и цену
OpenRouter может отправить запрос к следующей модели, если первая недоступна, получила rate limit, вернула ошибку или отказалась отвечать. Смотри на модель, которая ответила фактически, не только на ту, которую указал первым.
Если второй провайдер не должен видеть данные клиента, автоматический fallback запрети или ограничь списком разрешённых моделей.
- Логируй конечную модель.
- Поставь лимит до первого платного теста.
Ключ, баланс и логи
Создай отдельный ключ для dev, задай ограничение и не вставляй его в браузерный JavaScript. В лог достаточно request id, model, статус, usage, время и причина fallback. Полный prompt — только при необходимости и после обезличивания.
Management API key — для управления ключами, не для chat completions. Обычный API-ключ и ключ управления не взаимозаменяемы.
- Разделяй dev и production.
- Проверяй баланс до нагрузочного теста.
import os
from openai import OpenAI
client = OpenAI(
base_url="https://openrouter.ai/api/v1",
api_key=os.environ["OPENROUTER_API_KEY"],
)
response = client.chat.completions.create(
model="openrouter/free",
messages=[{"role": "user", "content": "Проверь короткий тест."}],
max_tokens=64,
)
print(response.choices[0].message.content)OpenRouter или прямой API-провайдер
OpenRouter удобен, если тестируешь несколько моделей или хочешь менять поставщика без смены клиентского кода. Прямой API проще, когда модель уже выбрана, важны условия конкретного провайдера и второй слой маршрутизации не нужен.
Сравнивай цену, хранение данных, доступные параметры, обработку ошибок и то, кто отвечает за конечный запрос.
- Запиши, зачем тебе второй слой.
- Единый endpoint не гарантирует одинаковое качество.
Free, платный запрос, fallback или прямой API
| Критерий | Вопрос | Хороший признак |
|---|---|---|
| Free | Когда использовать? | Проверить ключ, endpoint и простой prompt на небольшом объёме |
| Pay-as-you-go | Что получаешь? | Выбираешь модель и платишь за фактически использованный маршрут |
| Fallback | Что контролировать? | Порядок моделей, класс данных, конечную цену и причину переключения |
| Прямой API | Когда проще? | Модель уже выбрана и отдельная маршрутизация не нужна |
На выходе у тебя управляемый маршрут
Один ключ, первая модель, запасной маршрут и запись, сколько стоил тест. Единая точка входа с лимитами, не безлимитный доступ ко всему.
Где единый ключ начинает стоить дорого
Список моделей не ответит, кто лучше справится с твоим входом. Отправь одинаковую выборку и посчитай ручные исправления.
Лимиты и доступность free-моделей подходят для проверки. Стабильный рабочий маршрут они не обещают.
Запрос может попасть к другой модели по другой цене. Ограничь список и поставь лимит до автоматизации.
Его можно достать и использовать за твой счёт. Держи ключ на сервере, в логах оставляй минимум.
Каталог, алиасы и цены обновляются. Получай актуальные данные через каталог или Models API.
Когда пора подключать в продукт
Если через OpenRouter идут клиентские документы, автоматические действия или несколько окружений, заранее задай разрешённые модели, лимит и правило fallback.
Частые вопросы про OpenRouter
Что такое OpenRouter?
Единый API-слой и каталог моделей разных провайдеров. Запрос на один endpoint, модель выбираешь по актуальному ID.
Можно ли пользоваться OpenRouter бесплатно?
Да: free-модели (`:free`) и router `openrouter/free`. На 2026-08-08 docs: 20 RPM; 50 RPD без ≥10 credits, 1000 RPD после. Условия меняются — сверяй FAQ/Limits.
Как выбрать модель?
Возьми две модели из актуального каталога и отправь им одинаковую обезличенную выборку. Сравни качество, задержку, usage, цену и ручные исправления.
Что такое fallback?
Список запасных моделей. Если первая недоступна или вернула ошибку, OpenRouter пробует следующую. Учитывай данные и цену конечной модели.
Где хранить OpenRouter API key?
На сервере или в секретах окружения. Не вставляй в браузерный JavaScript, репозиторий и скриншоты. Для dev и production — разные ключи.
Нужна ли карта для первого теста?
Для free-маршрута условия сверяй в актуальном аккаунте. Для платных моделей и credits заранее проверь Pricing и поставь лимит расходов.
