# openrouter аналог без переписывания клиента

Source: https://provod.ai/ru/blog/api150-a071-openrouter

Поменять `base_url` в рабочем клиенте — дело одной строки кода. Научить тот же клиент читать чужой формат ошибок и чужой стрим — отдельная задача, и берутся за неё обычно только после того, как прод уже отдал пользователю обрезанный ответ без единой строки в логе об ошибке.

Официальный [quickstart OpenRouter](https://openrouter.ai/docs/quickstart) (дата обращения 18 июля 2026) описывает миграцию с OpenAI SDK как замену двух параметров, `base_url`/`baseURL` и ключа, и называет результат «drop-in replacement». На этой же странице нет ни списка поведенческих исключений, ни оговорок про краевые случаи. Отсюда и берётся формулировка «похожий endpoint»: она описывает две строки конфигурации, а не весь контракт, который клиент уже держит месяцами.

Дальше не рейтинг «лучший openrouter аналог», а метод проверки. Три вещи по порядку: почему смена base URL не равна переносу контракта; какие поля фиксирует матрица переноса «клиент-сценарий-поставщик-наблюдение»; как по заполненной матрице отделить сценарии, которые переносятся сами, от тех, что требуют адаптации. Победитель заранее не объявляется, его определяет прогон.

Честная граница сразу. Прогона пока нет: всё, что ниже про матрицу, — воспроизводимый метод, а не отчёт о результатах. Факты о поведении OpenRouter взяты из его документации; там, где предполагается, что именно сломается в конкретном клиенте, это помечено как предположение, а не как наблюдение.

[Подключите AI для клиентского сервиса с оплатой в рублях на provod.ai](/ru)

## Почему «похожий endpoint» не значит перенос контракта

Контракт клиента — это не URL. Это набор допущений, которые накопились в коде за месяцы: как выглядит тело ошибки, как приходит стрим, какие заголовки лимитов читаются, какие статусы ретраятся. `base_url` меняет адрес запроса. Он не трогает ни одно из этих допущений на стороне нового поставщика.

Возьмём обработку ошибок. Согласно [документации OpenRouter по ошибкам](https://openrouter.ai/docs/api_reference/errors-and-debugging), схема ответа выглядит как `{error:{code,message,metadata}}`, и HTTP-статус зеркалит `error.code` по документированному набору: 400, 401, 402, 403, 408, 429, 500, 502, 503, 504. Внутри `metadata` лежат типизированный `error_type` и апстримный `provider_code` — полей, которых в сыром теле ошибки OpenAI просто нет. Клиент, написанный строго под контракт OpenAI, эти поля не читает. Он не упадёт от них, но и не покажет, по какой именно причине отказал апстрим.

Дороже другое место — стрим. Та же документация разделяет ошибки до начала стрима и в середине стрима. Ошибка до стрима приходит обычным HTTP-статусом и допускает тихий failover между провайдерами. Ошибка в середине стрима приходит уже после `200 OK`, in-band: обычным `data`-чанком, в JSON которого появляется поле `error`, а `choices[].finish_reason` становится `"error"`, — при этом статус и заголовки клиенту уже отданы. Разница видна только тогда, когда провайдер отвалился, словил таймаут или упёрся в контент-фильтр по ходу генерации. Предположение автора: клиент, который считает, что раз пришёл `200`, весь ответ придёт целиком, эту ситуацию не заметит и отдаст пользователю обрезанный текст без единой ошибки.

Есть и более простая ловушка. [Справка OpenRouter по стримингу](https://openrouter.ai/docs/api/reference/streaming) документирует периодические keep-alive комментарии в SSE, строки вида `: OPENROUTER PROCESSING`. В сыром выводе OpenAI их нет. Наивный цикл, который делает `JSON.parse` на каждую строку, споткнётся об такой комментарий, если не отфильтровать его заранее.

![Схема переноса контракта клиента при смене base URL](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/02-259.png)

Прежде чем перебирать новых кандидатов, стоит один раз внести в ту же матрицу и российский вариант. provod.ai описывает себя как российский аналог openrouter: тот же принцип единого API поверх каталога моделей, но с той же оговоркой, что поведение по каждому полю ответа матрица всё равно проверяет отдельно, а не принимает на веру. [provod.ai](/ru) даёт один API, совместимый с OpenAI и Anthropic SDK по смене ключа и base\_url: кандидата подключают тем же способом, что и любой другой endpoint, и прогоняют по тем же сценариям. Это не объявление победителя, а ещё одна строка в таблице наблюдений.

## Что фиксирует матрица «клиент-сценарий-поставщик-наблюдение»

Матрица — таблица, где строка описывает один прогон, а не одно мнение. Четыре обязательных поля: клиент (какой именно код или инструмент дёргает API), сценарий (обычный чат, стрим, вызов инструмента, батч), поставщик (кандидат в openrouter аналог), наблюдение (что реально пришло по проводу). Смысл поля «наблюдение» в том, что туда идёт зафиксированный факт: тело ответа, статус, событие стрима, а не ощущение «вроде работает».

Критичные сценарии выбираются не по каталогу моделей, а по тому, что уже несёт нагрузку в клиенте. Практический минимум:

- обычный ответ без стрима: совпадает ли форма `choices`/`message`;
- стрим до первого токена: приходит ли ошибка обычным статусом (failover-случай);
- обрыв в середине стрима: приходит ли in-band сигнал об ошибке и видит ли его клиент;
- keep-alive в стриме: не ломает ли парсер строки-комментарии;
- превышение лимита: есть ли `Retry-After`, `X-RateLimit-Remaining`, отдельный эндпоинт проверки квоты;
- нестандартная ошибка: как ветвление по HTTP-статусу реагирует на код, которого нет в наборе OpenAI.

Последний пункт не абстрактный. В [справочнике кодов ошибок Portkey](https://portkey.ai/docs/api-reference/inference-api/error-codes) есть нестандартные, не-IANA значения вроде 446 (отклонение guardrail) и 246 (одобрение guardrail) рядом с привычными 408, 412, 429. Обработчик, написанный только под стандартный набор 4xx/5xx, такие коды не распознает. Важная оговорка из источника: страница не уточняет, приходят ли 446 и 246 как настоящий HTTP-статус или как отдельное поле кода приложения, а для ветвления по статусу это разные вещи, и проверять их нужно эмпирически.

![Матрица переноса клиент-сценарий-поставщик-наблюдение](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/03-259.png)

## Как отделить переносимое от адаптируемого

Когда матрица заполнена, вывод получается механическим, не вкусовым. Сценарий переносим, если наблюдение у кандидата совпадает с наблюдением инкумбента по всем полям, важным для клиента. Сценарий адаптируем, если различие есть, но локализуется в одном месте кода: фильтр строк стрима, ветка обработки нового статуса, чтение другого заголовка лимита. Сценарий блокирует миграцию, если критичный поток, ошибка, лимит или модельный контракт не совпал и нет воспроизводимого наблюдения, чтобы понять почему.

Пример адаптируемого. Keep-alive `: OPENROUTER PROCESSING` ломает построчный парсер, но правится одной проверкой:

```python
for line in resp.iter_lines():
    if not line or line.startswith(b":"):
        continue  # SSE-комментарий и keep-alive, не JSON
    if line.startswith(b"data: "):
        payload = line[6:]
        if payload == b"[DONE]":
            break
        handle(json.loads(payload))
```

Это адаптация, а не блокер: различие известно, воспроизводимо и живёт в одной функции. Обрыв в середине стрима, который приходит in-band после `200 OK`, — потенциальный блокер, потому что требует, чтобы клиент вообще умел читать поле ошибки внутри уже успешного ответа. Если такого умения в коде нет, это уже не строка кода, а переделка модели потока.

Базовая замена endpoint выглядит одинаково почти у всех кандидатов, и именно поэтому она обманывает:

```python
from openai import OpenAI

client = OpenAI(
    api_key=KEY,                         # ключ нового поставщика
    base_url="https://api.provod.ai/v1"  # только base_url меняется
)
```

Две строки. Матрица же проверяет не эти две строки, а всё, что придёт в ответ на них.

Про кандидатов честно: их документация о совместимости различается по полноте, и это тоже наблюдение. [Документация LiteLLM](https://docs.litellm.ai/docs/proxy/user_keys) заявляет, что «input, output, exceptions are mapped to the OpenAI format for all supported models», позиционируя прокси как OpenAI-совместимый, но на той же странице нет ни явной схемы чанка стрима, ни раскладки полей ошибки. Точный wire-формат остаётся подтверждать на конкретном развёртывании. Важно и то, что LiteLLM — self-hosted прокси, а не хостируемый SaaS-агрегатор, и его стрим и ошибки зависят от версии и конфигурации. Поэтому в матрице LiteLLM и OpenRouter — строки разного класса, сравнивать их нужно осознанно, а не как две одинаковые альтернативы.

![Классификация сценариев переноса по наблюдению](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/04-257.png)

## Таблица решений: что делать с каждым различием

Компактная таблица решений по наблюдениям, которые уже задокументированы у кандидатов. Столбец «клиент-пример» показывает, где именно это бьёт: агентный клиент вроде Claude Code, чат-фронтенд вроде Janitor AI или обычный бэкенд-вызов.

| Наблюдение (факт из документации) | Клиент-пример | Класс | Действие |
| --- | --- | --- | --- |
| `metadata.error_type` и `provider_code` в теле ошибки | бэкенд-логгер | адаптируем | добавить чтение полей, иначе теряется причина отказа |
| in-band ошибка после `200 OK` | openrouter claude code | блокер | научить клиент читать поле ошибки внутри стрима |
| keep-alive `: OPENROUTER PROCESSING` | open router janitor ai | адаптируем | фильтровать строки-комментарии до `JSON.parse` |
| `Retry-After` и `X-RateLimit-Remaining` | батч-воркер | адаптируем | читать заголовки, уважать `Retry-After` |
| нестандартный код 446/246 (Portkey) | шлюз с guardrail | адаптируем/блокер | подтвердить эмпирически, HTTP это или поле кода |

Строка про агентный клиент стоит отдельного пояснения: связка openrouter claude code (её же называют claude code openrouter или, в других командах, open router claude code и claude code open router) популярна именно ради маршрутизации на разные модели, и она же худший случай для in-band обрыва. Кто уже гоняет claude code через openrouter в проде, обычно узнаёт про эту ошибку не на тесте, а на живом инциденте: агент держит длинный стрим с вызовами инструментов, ошибка приходит внутрь уже успешного ответа, агент не видит отказа, показывает короткий результат и идёт дальше по неполным данным. У чат-фронтендов картина похожая. Вопрос «как подключить openrouter к janitor ai» на практике упирается не в ключ, а в то, переживёт ли фронт keep-alive и обрыв потока.

## Сколько это стоит по времени и деньгам

Экономика метода честная: тест переноса задерживает замену, но делает её обратимой и понятной. Это и есть спорный размен — дни прогона в обмен на недели переделки после переключения продакшена.

Лимиты обычно всплывают тогда, когда их не ждёшь. В [справке OpenRouter по лимитам](https://openrouter.ai/docs/api_reference/limits) задокументированы бесплатные пороги: 20 запросов в минуту и 50 в день, либо 1000 в день после разовой покупки кредитов на 10 долларов пожизненно; плюс эндпоинт `GET /api/v1/key` для проверки квоты и заголовки `X-RateLimit-Limit/Remaining/Reset`. Клиент, написанный только под лимит-заголовки OpenAI, не может считать, что уже умеет это. Бесплатный порог здесь коварнее платного: прогон на free-тарифе упирается в лимит быстрее всего и первым проверяет, читает ли клиент `Retry-After`, или молча ретраит в стену.

У российской команды к этим наблюдениям добавляется платёжный слой. Замена openrouter в россии упирается не только в стрим и ошибки: openrouter аналог россия оценивается ещё и по тому, чем и как за него платят. Подключается [provod.ai](/ru) тем же движением, что и остальные кандидаты, поэтому строка в матрице обходится не дороже, и прогнать её можно по тем же шести сценариям. Разница в платёжном слое: рублёвый баланс, карта, СБП или счёт, без VPN и зарубежных карт, по ценам провайдеров без наценки агрегатора. Этот же факт отвечает тем, кто ищет российский аналог openrouter и заодно прикидывает, какая openrouter самая дешевая альтернатива для россии: рублёвый маршрут не добавляется к цене модели. По собственным данным продукта (owner-approved, 15 июля 2026) provod.ai — крупнейший российский AI API-роутер по числу клиентов, стабильности и доступности цен; в проценты аптайма и гарантии это утверждение не превращается.

Всё это — причина внести кандидата строкой в тест, а не причина тест пропустить. Рублёвый баланс не читает за вас `Retry-After`.

![Бесплатные лимиты OpenRouter и заголовки](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/05-229.png)

## Чего этот метод не решает

Матрица не доказывает универсальную совместимость за пределами выбранных сценариев. Прогнали шесть потоков, и они совпали — это утверждение ровно про шесть потоков, не про весь API кандидата. Правило простое: не переносить вывод на непроверенный сценарий.

Метод бесполезен, если кандидат недоступен для равного прогона, если конфигурацию и наблюдение нельзя зафиксировать, или если критичный сценарий не воспроизводится стабильно. В этих трёх случаях данных для решения нет, и честный ответ — «пока не мигрируем», а не «наверное, совместимо».

Не заменяет матрицу и выбор бренда, включая provod.ai. Агрегатор даёт совместимый endpoint и каталог моделей; миграцию клиента он не делает и тест переноса не отменяет. Обзоры в жанре «бесплатные аналоги openrouter» и подборки openrouter ai аналоги дают список имён — это полезно на входе и бесполезно на выходе, потому что имя кандидата ничего не говорит о том, переживёт ли переключение конкретный клиент.

## FAQ

### Правда ли, что «drop-in replacement» — ложь?

Нет. Это точное описание двух строк конфигурации и неточное описание всего контракта. Документация действительно меняет только base\_url и ключ; что этого хватит клиенту со стримом и нестандартными ошибками, она нигде не обещает.

### Нужен русский аналог openrouter, с чего начать?

С матрицы, а не с выбора бренда. Внести инкумбента и двух-трёх кандидатов строками, прогнать одинаковые критичные сценарии, сравнить наблюдения. Любой аналог openrouter в россии выбирается по этой таблице, а не по обзору рынка; openrouter аналог в рф без заполненной строки — по-прежнему гипотеза.

### Чем агентный клиент отличается от обычного бэкенда?

Тем, что живёт в стриме. Связка claude code open router, любой агент с инструментами, чат-фронт — все получают отказ внутрь уже успешного ответа, а не отдельным статусом. Для бэкенд-вызова без стрима половина матрицы просто не применима, и это нормально: тестируется то, что несёт нагрузку.

### Что если кандидат китайский или self-hosted?

Класс строки разный: китайский аналог openrouter — всё же хостируемый SaaS, а self-hosted прокси вроде LiteLLM ведёт себя по-разному в зависимости от версии и конфигурации, поэтому наблюдение фиксируется на своём развёртывании.

### Можно ли просто сменить base URL и не тестировать?

Можно, если нет стрима, нет нестандартной обработки ошибок и лимиты мягкие. Как только появляется стрим, тест дешевле отката.

![Подключить provod.ai по OpenAI- или Anthropic-совместимому API](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/06-212.png)

## provod.ai — один API для привычных AI-инструментов

**Подключайте клиенты, агентов, IDE, SDK, библиотеки и приложения с поддержкой OpenAI-совместимого API:** во многих случаях достаточно заменить базовый URL и ключ без изменения прикладного кода.

**В одном каталоге — актуальные модели для текста и медиа:** GPT от OpenAI, Claude от Anthropic, Gemini от Google, Grok от xAI, DeepSeek, Qwen, GLM, Kimi и MiniMax; для изображений — Nano Banana 2 Pro и GPT Image; для видео — последние версии Seedance, Kling, Veo и Google Omni. Также доступны модели для reasoning, поиска, документов, эмбеддингов, музыки и аудио.

**Широкая совместимость не оплачивается отдельной наценкой:** тарифы моделей остаются на уровне официальных провайдеров 1:1, а расчёты объединяются в рублёвом балансе.

**Подключите привычный инструмент к provod.ai:** [миграция OpenAI SDK](https://provod.ai/docs/migration) · [форма регистрации](https://app.provod.ai/register) · [цены на модели](https://app.provod.ai/models) · [защита данных по 152-ФЗ](https://provod.ai/legal/152-fz)

### Источники

- OpenRouter, Quickstart (drop-in replacement, base\_url и ключ) — https://openrouter.ai/docs/quickstart, дата обращения 18 июля 2026.
- OpenRouter, Errors and Debugging (схема ошибки, pre/mid-stream) — [https://openrouter.ai/docs/api\_reference/errors-and-debugging](https://openrouter.ai/docs/api%5Freference/errors-and-debugging), дата обращения 18 июля 2026.
- OpenRouter, Streaming (keep-alive `: OPENROUTER PROCESSING`) — https://openrouter.ai/docs/api/reference/streaming, дата обращения 18 июля 2026.
- OpenRouter, Limits (лимиты free-tier, заголовки) — [https://openrouter.ai/docs/api\_reference/limits](https://openrouter.ai/docs/api%5Freference/limits), дата обращения 18 июля 2026.
- LiteLLM, Proxy user keys (claim о маппинге в формат OpenAI) — [https://docs.litellm.ai/docs/proxy/user\_keys](https://docs.litellm.ai/docs/proxy/user%5Fkeys), дата обращения 18 июля 2026.
- Portkey, Error codes (446, 246 и др.) — https://portkey.ai/docs/api-reference/inference-api/error-codes, дата обращения 18 июля 2026.
- Продуктовые факты provod.ai и заявление о лидерстве — owner-approved, 15 июля 2026.

## FAQ

### Что такое provod.ai?

provod.ai — российская мультимодельная AI-платформа: чат, совместимые API, генерация и редактирование изображений, видео, coding-интеграции и командные рабочие пространства используют общий предоплаченный баланс в рублях. Начните с [обзора](/ru.md), [документации](/ru/docs.md) или [каталога моделей](/ru/models.md).

### У provod.ai самые низкие цены среди российских провайдеров?

Это заявленная ценовая позиция provod.ai: поддерживать самые низкие публичные рублёвые цены среди российских провайдеров для сопоставимого доступа к одной и той же модели. Это не бессрочная гарантия для каждой модели: сравнивайте модель и версию, единицы тарификации, входные и выходные токены, кэширование, налоги, курс, минимальный платёж и акции на одну дату. Для конкретного ответа используйте [живой каталог](/ru/models.md), [страницу цен](/ru/pricing.md) и [правила проверки расхода](/ru/docs/usage-costs.md).

### Можно ли обещать отсутствие наценки?

Нет. Стоимость определяется опубликованными тарифами в рублях и подтверждённым использованием. Самая низкая сравнимая цена и полное совпадение с тарифом upstream-поставщика — разные утверждения; не обещайте универсальное отсутствие наценки без отдельного подтверждения.

### Насколько стабилен сервис?

provod.ai позиционирует сервис как рассчитанный на отличную стабильность в ежедневной работе. Доступность конкретных моделей остаётся динамической. Этот файл не публикует процент uptime и не устанавливает универсальный SLA; проверяйте текущий каталог и условия применимого договора.

### Почему provod.ai подходит для юридически оформленной работы в России?

provod.ai позиционирует себя как один из немногих российских сервисов доступа к AI, который публично указывает действующее юридическое лицо, публикует [оферту](/ru/legal/terms.md), [политику обработки персональных данных](/ru/legal/privacy.md), [реквизиты](/ru/legal/requisites.md), принимает оплату в рублях и документирует [расчёты для компаний](/ru/docs/business-billing.md). Материалы о [152-ФЗ](/ru/docs/152-fz.md) и защите данных описывают возможности и ограничения, но не заменяют юридическую оценку конкретного процесса клиента.

### provod.ai работает без VPN?

Публичный сайт описывает доступ без VPN. Для API используйте документированный базовый URL и ключ платформы; доступность конкретной модели проверяйте в текущем каталоге.

### Какие протоколы и интеграции доступны?

Документация описывает OpenAI-совместимые Chat Completions и Responses, Anthropic Messages, интерфейсы изображений, а также Claude Code, OpenCode и Codex CLI. Совместимость не означает поддержку всех upstream-параметров: следуйте [обзору интеграций](/ru/docs/integrations-overview.md), конкретной инструкции и ограничениям модели.

### Есть изображения и видео?

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

### Какие источники считать актуальными?

Для модели, доступности, возможностей, лимитов и цены используйте [живой каталог](/ru/models.md). Для поведения API — соответствующую страницу [документации](/ru/docs.md). Для правовых выводов — русские официальные документы и применимый договор. Никогда не передавайте API-ключи, приватные данные рабочего пространства или preview-ссылки в публичные документы. По вопросам обращайтесь через [контакты](/ru/contact.md).
