OpenAI-совместимый API: что проверить до пополнения баланса

OpenAI-совместимость обычно описывает конкретный формат запросов, а не поддержку всех возможностей OpenAI. До покупки проверьте endpoint, модель и функции, которые использует ваше приложение. Успешный текстовый ответ не подтверждает работу инструментов, изображений или Responses API.

Три штекера разной формы стоят напротив подходящих разъёмов фиолетового шлюза

Проверяйте OpenAI-совместимый API по операциям, которые нужны вашему приложению: «поддерживает OpenAI» без названия endpoint недостаточно. Совместимость зависит от всей цепочки: клиент → формат запроса → маршрут провайдера → модель.

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

Сначала определите, какой API использует клиент

Откройте настройки клиента или его документацию. Узнайте, какой формат запросов клиент отправляет и как разбирает ответы.

Формат Типичный путь Что важно при переносе
OpenAI Chat Completions /v1/chat/completions messages, формат choices, вызовы инструментов и параметры модели
OpenAI Responses /v1/responses input, типизированный output, события и работа с состоянием
Anthropic Messages /v1/messages Заголовки, блоки содержимого, инструменты и причина завершения

Пути приведены для привычной базы /v1; конкретный шлюз может использовать другой префикс. Полный адрес берите из его документации.

В руководстве OpenAI по переходу на Responses отдельно описаны изменения входа, выхода и хранения состояния. Нельзя заменить в старом коде только слово chat/completions на responses и оставить прежний разбор ответа.

У Anthropic есть собственный Messages API. Если посредник отдаёт Claude через Chat Completions, это его слой преобразования: поддержку нативных возможностей выясняйте отдельно.

Составьте матрицу нужных функций

Уточните у провайдера каждую функцию, которую использует ваше приложение:

Что использует приложение Что нужно подтвердить Какой результат проверить
Обычный текст Endpoint и точный ID модели Ответ в ожидаемом поле
Стриминг Формат событий и завершение потока Все фрагменты и итоговый статус
Вызовы инструментов tools, выбор инструмента, возврат результата Полный цикл до финального ответа
Структурированные данные Поддержка JSON Schema, а не только JSON mode Схема принята, результат валидируется
Изображения Способ передачи: URL или данные файла Модель действительно получает изображение
PDF и другие файлы Поддерживаемая загрузка и срок жизни файла Файл доступен выбранной операции
Длинный контекст Лимит конкретного предложения Запрос нужного размера принимается
Кеширование Условия и поля usage Чтение кеша отражается в счёте

Если ваш бот использует только текст, не нужно откладывать запуск ради проверки всех остальных строк. Для агента с инструментами, напротив, одного ответа «привет» мало.

Базовый адрес и ID — две независимые настройки

base_url у SDK обычно содержит базу API, например https://api.example.com/v1. Метод SDK добавляет путь операции сам. В ручном HTTP-запросе задают полный URL. Сверьте правило именно своей библиотеки: некоторые клиенты иначе соединяют базу и путь.

Не выбирайте URL перебором знакомых суффиксов. При ошибке 404 на /v1/v1/chat/completions проверьте, откуда взялся повторный префикс.

Идентификатор также нужно копировать у поставщика. Один шлюз использует gpt-4.1-mini, другой — openai/gpt-4.1-mini. Маркетинговое название в карточке модели может отличаться от значения поля model.

В каталоге LLMFinder найдите нужную модель и предложение, затем откройте источник и документацию. Разбор различий идентификаторов при переезде есть в статье об альтернативе OpenRouter.

Проверяйте от простого к рабочему сценарию

  1. Сохраните версию клиента, базовый адрес, ID модели и дату проверки. Создайте отдельный тестовый ключ с ограничениями, которые предлагает поставщик.
  2. При наличии операции списка моделей проверьте точный ID. Не считайте отсутствие списка окончательным доказательством отсутствия генерации.
  3. Отправьте один короткий текстовый запрос без дополнительных параметров. Сохраните HTTP-статус, request ID, usage и фактическое списание, если оно доступно.
  4. Добавляйте по одной необходимой функции: сначала поток, затем JSON, затем инструмент. Так видно, какой параметр изменил поведение.
  5. Повторите полный сценарий приложения на вымышленных данных. Для инструмента это включает его результат и следующий ответ модели.
  6. Сверьте бюджет и обработку ошибок. Полный цикл может включать несколько оплачиваемых вызовов.

Не переносите рабочий ключ или реальные клиентские документы в онлайн-«тестеры API». Подключение проверяется вашим приложением или доверенным локальным инструментом.

Диагностика ошибок

Ответ Возможная причина Следующее действие
401/403 Неверный ключ, права или ограничения доступа Сверить хост, credential и правила аккаунта
404 Неверный путь либо неизвестная модель Разделить проверку URL и поля model
400 Неподдерживаемый параметр или неверное тело Свести запрос к минимальному и читать описание ошибки
429 Лимит нагрузки или квоты Проверить вид ограничения
200, но клиент не показывает ответ Несовпадение формата ответа или событий Проверить сырой ответ без публикации секретов

HTTP 200 не гарантирует завершённый поток: Anthropic прямо описывает ошибки после начала SSE-ответа. Проверяйте итоговое событие и ошибки клиента.

Как сравнить предложения после проверки

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

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

Для настройки автоматизации используйте инструкцию n8n. Работа со структурированными данными разобрана в статье о JSON Schema. Актуальные опубликованные цены и условия оплаты сравнивайте в каталоге.

Частые вопросы

OpenAI-совместимый API поддерживает Responses?

Не обязательно. Поддержку /responses нужно подтверждать отдельно для выбранного провайдера, модели и клиента. Совместимость только с /chat/completions не означает поддержку Responses.

Можно ли подключить Claude через библиотеку OpenAI?

Можно, если провайдер предлагает для этой модели OpenAI-совместимый маршрут. Это не равно нативному Anthropic Messages API: поля и доступные функции могут отличаться.

GET /models доказывает, что модель доступна?

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

Читайте также