OpenRouter модели: как сопоставить каталог с Relay
В OpenRouter модели выбирают по его каталогу; при переходе на Relay идентификаторы нужно сверить заново. Найдите нужную модель в каталоге Relay, проверьте протокол и возможности, затем отправьте тестовый запрос. Совпадение названия семейства не означает, что два API принимают одинаковый ID и все параметры вашего приложения.
Как сопоставить модели OpenRouter и Relay
Начните с фактического запроса приложения. Выпишите значение model, используемый маршрут API, потоковый режим, инструменты и параметры формата ответа. Это покажет, какую совместимость надо проверить: обычный текстовый ответ требует меньше условий, чем агент с вызовами функций.
Ищите модель в каталоге Relay по разработчику и названию. Скопируйте public_id из найденной карточки. Не удаляйте префикс из OpenRouter ID механически: у модели может отличаться версия, а похожее имя может указывать на другую позицию.
Составьте соответствие в конфигурации приложения явно. Для каждой исходной записи зафиксируйте выбранный ID Relay и причину выбора. Если точной модели нет, проверьте ответы нового кандидата на тех же заданиях. Одного работающего соединения недостаточно.
Что проверить кроме названия
Каталог Relay содержит протоколы, размер контекста, максимальный выход и признаки поддержки возможностей. Для переноса сверьте:
Протокол.
openai_chatсоответствует Chat Completions,openai_responsesсоответствует Responses. Один маршрут не подменяет другой.Инструменты. Если приложение отправляет
tools, выбранная модель должна поддерживать их. Успешный ответ на «Привет» этого не проверяет.Изображения. Для анализа картинки нужен вход с изображением и поддержка vision. Модель генерации изображений выполняет другую задачу.
Контекст. Учитывайте системную инструкцию, историю диалога, описания инструментов и вложенный текст. Длина последнего сообщения не равна всему входу.
Выход. Сверьте предел ответа и параметры, которыми приложение его ограничивает. Обрезанный JSON может быть следствием короткого выхода.
Например, в текущем каталоге Relay gpt-5.6-luna поддерживает Chat Completions, Responses и Anthropic Messages. Нельзя менять только строку модели, оставив неподходящий маршрут. Описание публичных полей доступно в Models API.
Как проверить запрос после смены API
Ниже пример для Python и установленного пакета openai. Он проверяет обычный текстовый ответ модели deepseek-v4-flash через Chat Completions. Это конкретный кандидат для теста, а не автоматическая замена любой модели из OpenRouter Models.
export RELAY_API_KEY="sk-demo-not-a-real-key"import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["RELAY_API_KEY"],
base_url="https://relay-llm.ru/v1",
timeout=60.0,
max_retries=0,
)
response = client.chat.completions.create(
model="deepseek-v4-flash",
messages=[{
"role": "user",
"content": "Извлеки номер заказа из фразы: заказ R-17 готов. Верни только номер.",
}],
)
print(response.choices[0].message.content)
print(response.usage)Рабочий ключ передавайте через окружение; строка sk-demo-not-a-real-key не авторизует запрос. Пример отключает повторы SDK, чтобы при разборе ошибки одно действие программы не скрывало несколько попыток.
После первого ответа отдельно проверьте поток, вызов инструмента и длинный вход, если приложение их использует. Провайдерские параметры из прежнего запроса переносите только после сверки с документацией Relay. Поддержка OpenAI-совместимого формата не доказывает поддержку каждого расширения OpenRouter.
Как сравнить цену и качество после переноса
Возьмите реальные примеры без секретов. Для извлечения полей проверяйте точные значения и обработку пропусков; для кода запускайте тесты; для ответа поддержки проверяйте обязательные факты и отсутствие выдуманных условий. Не заменяйте эти проверки общей оценкой «ответ выглядит лучше».
Отдельно записывайте API-ошибки и ошибки содержания. Если модель не вызвана из-за неверного ID, её качество пока не оценено. Если получен корректный HTTP-ответ с неверным номером заказа, соединение работает, но задача не решена.
Цена успешного результата включает все оплаченные попытки, которые понадобились для его получения. Ставки входа, выхода и кэша смотрите на странице цен, итог вызова в журнале запросов. Не считайте более низкую ставку гарантией меньшего бюджета: длинные ответы и повторы могут изменить итог.
Что делать, если нужной модели нет
Проверьте точное название и версию в каталоге. Если позиция отсутствует, не придумывайте ID и не обещайте пользователям прежнее поведение под другим названием. Оставьте старое подключение для этой задачи либо выберите доступного кандидата и проведите отдельный тест.
Сохраните прежнюю конфигурацию до переключения рабочего трафика. При расхождении результатов вы сможете вернуть исходный маршрут и изучить ошибку на том же входе, не восстанавливая настройки по памяти.
Почему модели OpenRouter не находятся по прежнему ID в Relay?
Каждый сервис публикует свой каталог идентификаторов. Найдите соответствующую модель в Relay и скопируйте её public ID целиком.
Можно ли перенести приложение, поменяв только base URL?
Проверьте также ключ, модель, маршрут и специфичные параметры. Для простого Chat Completions запроса перенос может быть коротким, но инструменты и поток требуют отдельных проверок.
Что означает OpenRouter AI Models в инструкции клиента?
Обычно это ссылка на выбор моделей OpenRouter. Для Relay источником ID и возможностей служит собственный каталог Relay; название списка в клиенте не меняет API-контракт.
Как выбрать замену отсутствующей модели?
Сначала отберите кандидатов по протоколу, контексту и инструментам, затем сравните их на задачах приложения с проверяемым результатом.