OpenAI-совместимый API: что это и как подключить

Андрей из LLMost
· 5 мин чтения

Короткий ответ: OpenAI-совместимый API — это негласный стандарт индустрии, «USB-разъём» мира нейросетей. Когда-то OpenAI придумала формат, в котором программы обращаются к ChatGPT, — и он оказался настолько удобным, что его скопировали почти все: сегодня в этом формате отдают свои модели DeepSeek, Qwen, xAI и десятки сервисов-агрегаторов. Практическое следствие: любое приложение, «умеющее в OpenAI», можно за пару минут переключить на другого провайдера и другие модели — достаточно поменять два поля, адрес сервера и ключ. Разберёмся, как это устроено и как этим пользоваться, — без программирования и с ним.
Как это работает на пальцах
Когда приложение (чат-клиент, телеграм-бот, плагин для редактора) хочет получить ответ нейросети, оно отправляет на сервер запрос строго определённой формы: «вот история сообщений, вот название модели — верни продолжение». Форму этого запроса задала OpenAI, и она стала стандартом де-факто — как раскладка QWERTY или разъём USB.
Из стандарта вытекают три вещи, важные для обычного пользователя:
- Приложения и провайдеры взаимозаменяемы. Сотни готовых программ — чат-клиенты, боты, расширения браузера, плагины для «Кода» и Obsidian — умеют говорить на этом языке. И любой совместимый провайдер подходит им всем.
- Настройка везде одинакова и сводится к двум полям. Base URL — адрес сервера, куда слать запросы. API-ключ — ваш «пароль», по которому сервер понимает, чей это запрос и с какого баланса списывать оплату.
- Модели не привязаны к вендору. Через один и тот же совместимый API можно обращаться и к GPT, и к Claude, и к Gemini, и к DeepSeek — если провайдер их проксирует. Именно так устроен LLMost: один ключ — сотни моделей.
Для России это особенно удобно: прямые API OpenAI, Anthropic и Google из РФ недоступны, а совместимый провайдер с российской пропиской решает сразу обе проблемы — и доступ, и оплату в рублях.
Что нужно для подключения
На примере LLMost (у других провайдеров всё аналогично, меняются только значения):
- Base URL:
https://llmost.ru/api/v1 - API-ключ: создаётся в личном кабинете, начинается с
llmost_... - Название модели: берётся из каталога, например
~openai/gpt-latestили~anthropic/claude-sonnet-latest— алиасы «latest» всегда указывают на актуальную версию, так что настройка не устареет.
Всё. Никаких VPN, зарубежных карт и танцев с регистрацией у пяти вендоров.
Способ 1: готовые приложения — без единой строчки кода
Самый частый сценарий — подключить красивый чат-клиент, который умеет больше, чем веб-чат: локальная история, папки, промпт-библиотеки, работа с файлами. Три проверенных варианта из нашего каталога приложений:
LobeChat — пожалуй, самый красивый открытый чат-клиент. В настройках провайдеров добавьте кастомного провайдера типа OpenAI, вставьте Base URL и ключ, нажмите «Fetch models» — список моделей подтянется автоматически.
Cherry Studio — мощный десктопный клиент для Windows/macOS/Linux. Settings → Model Services → Add: тип OpenAI, адрес https://llmost.ru/api/v1, ключ. Кнопка «Manage» подтянет список моделей.
LibreChat — вариант для самостоятельного хостинга (интерфейс «как у ChatGPT», но на вашем сервере): совместимый провайдер прописывается в конфиге librechat.yaml как custom endpoint.
Тот же принцип работает в сотнях других программ: если в настройках есть поля «OpenAI Base URL» (иногда «API Host», «Endpoint», «Proxy URL») и «API Key» — приложение совместимо. Подробные пошаговые инструкции — в документации LLMost и карточках каталога приложений.
Способ 2: свой код — для разработчиков
Если вы пишете бота или скрипт, официальные SDK OpenAI работают с любым совместимым провайдером — меняется один параметр base_url:
from openai import OpenAI
client = OpenAI(
base_url="https://llmost.ru/api/v1",
api_key="llmost_...",
)
response = client.chat.completions.create(
model="~openai/gpt-latest",
messages=[{"role": "user", "content": "Привет! Что ты умеешь?"}],
)
print(response.choices[0].message.content)То же самое на JavaScript/TypeScript — new OpenAI({ baseURL: "https://llmost.ru/api/v1", apiKey: "llmost_..." }). А чтобы переключиться с GPT на Claude или DeepSeek, достаточно поменять строку model — код не меняется вовсе.
Помимо чата, стандарт покрывает и другие эндпоинты, которые LLMost тоже поддерживает: /embeddings (векторные представления текста для поиска и RAG), /images/generations (генерация картинок), потоковая передача ответов (streaming). Отдельный бонус для экосистемы Anthropic: LLMost поддерживает и родной формат Anthropic Messages API (/v1/messages) — а значит, работает даже с инструментами, заточенными строго под Claude, вроде Claude Code. Полное описание — в справочнике API.
Частые грабли
- Потерянный
/v1. Самая частая ошибка — указатьhttps://llmost.ru/apiвместоhttps://llmost.ru/api/v1. Часть клиентов дописывает/v1сама, часть нет; надёжнее всегда указывать полный адрес. - Ключ не от того сервиса. Ключ работает только у выдавшего его провайдера: ключ OpenAI не подойдёт к LLMost и наоборот.
- Неточное имя модели. Название должно совпадать с каталогом провайдера символ в символ. Если клиент умеет подтягивать список моделей — пользуйтесь этим вместо ручного ввода.
- «Совместимый» не значит «идентичный на 100%». Экзотические параметры и свежие фичи вендоров доезжают до стандарта с задержкой. Базовые сценарии — чат, streaming, картинки — работают везде одинаково.
Частые вопросы
Это только для программистов?
Нет. Готовые приложения подключаются через два поля в настройках — программировать не нужно. Код — лишь один из способов.
Чем API отличается от подписки на ChatGPT?
Подписка — фиксированная плата за чат на сайте вендора. API — оплата по факту за объём текста, которую можно использовать в любых приложениях. Для нерегулярного использования API почти всегда дешевле: подробная арифметика здесь.
Могу ли я подключить Claude или Gemini через OpenAI-совместимый API?
Да, если провайдер их проксирует. На LLMost через один совместимый эндпоинт доступны модели OpenAI, Anthropic, Google, DeepSeek, Qwen, xAI и других — весь список.
Это безопасно?
Запросы уходят провайдеру, которому вы доверили ключ, а от него — в официальные API вендоров. Правила гигиены обычные: не публикуйте ключ, а если утёк — отзовите в кабинете и создайте новый.
Качество ответов через совместимый API хуже?
Нет: отвечает та же модель через официальный API вендора. Формат запроса на качество не влияет.
Итог
OpenAI-совместимый API — это свобода выбора: один стандарт, два поля настройки — и перед вами сотни моделей и сотни приложений в любых сочетаниях. Попробовать проще всего так: возьмите ключ на LLMost (новичкам начисляются бесплатные кредиты), подключите понравившийся клиент из каталога приложений — и переключайтесь между GPT, Claude и DeepSeek в одном окне, платя в рублях по факту использования.