OpenAI-compatible API:
стандарт
для Cursor, RAG и ботов
Что такое OpenAI-compatible endpoint: base_url + ключ. Зачем команде один слой вместо разрозненных LLM API — и как подключить Gateway.
OpenAI-compatible API — это формат, который стал удобным общим языком для LLM-инструментов. Разработчик меняет base_url, оставляет привычный SDK и получает доступ к другой модели или другому шлюзу без переписывания всей интеграции.
Для команды это важнее, чем кажется. Когда API совместим с OpenAI-форматом, к нему проще подключать Cursor, ботов, backend, RAG-пайплайны, agent workflows и внутренние инструменты.
Коротко: OpenAI-compatible API — это не бренд OpenAI. Это практический интерфейс: endpoint, ключ, модель и стандартный формат запроса.
Из чего состоит совместимость
В простом виде команда видит четыре вещи:
- Base URL — адрес API, например
https://api-ru.agi-iri.ru/v1/. - API key — ключ доступа из кабинета.
- Model ID — идентификатор модели в каталоге.
- Формат запроса — привычные поля вроде
model,messages,temperature.
Если инструмент поддерживает OpenAI-compatible endpoint, его можно часто переключить на другой шлюз без тяжелой миграции. Именно поэтому этот формат стал стандартом де-факто для AI-инфраструктуры.
Где это используется
| Сценарий | Что дает совместимый API |
|---|---|
| Cursor / IDE | Можно использовать свой модельный слой и контролировать расходы. |
| Telegram-бот | Backend отправляет запросы в единый endpoint. |
| RAG | Можно менять модель без перестройки всей архитектуры. |
| AI-агенты | Оркестратор вызывает разные модели через общий интерфейс. |
| B2B-команда | Появляется единый контур ключей, лимитов и учета. |
Почему это удобно в России
Для российских команд проблема часто не только техническая. Нужны оплата в рублях, доступ без VPN, понятный кабинет, возможность пополнить баланс и иногда работа с юрлицом. OpenAI-compatible шлюз решает техническую часть, а локальный продуктовый контур — операционную.
IRI Gateway дает такой вход: один endpoint, каталог моделей, кабинет, баланс, документация и связка с Verstak.
Что проверить перед выбором
- Есть ли endpoint вида
/v1/. - Работает ли ваш SDK или инструмент без кастомной доработки.
- Понятно ли, какие модели доступны и сколько они стоят.
- Есть ли лимиты, кабинет, история расходов.
- Есть ли документация под ваш сценарий: Cursor, Claude Code, RAG, бот, агент.
Чем отличается Gateway от прямого API
Прямой API провайдера хорош, когда у вас есть доступ, оплата, юридические и технические условия. Gateway нужен, когда команда хочет один слой между продуктом и несколькими провайдерами моделей.
- модели можно менять быстрее;
- ключи не размазаны по личным аккаунтам;
- расходы видны в одном месте;
- инструменты подключаются через общий формат;
- можно строить не один prompt, а системный AI-контур.
Итог
OpenAI-compatible API — это базовый кирпич AI-инфраструктуры. Он не делает продукт умным сам по себе, но дает команде свободу менять модели, подключать инструменты и строить workflow вокруг единого модельного слоя.