Проверяйте OpenAI-совместимый API по операциям, которые нужны вашему приложению: «поддерживает OpenAI» без названия endpoint недостаточно. Совместимость зависит от всей цепочки: клиент → формат запроса → маршрут провайдера → модель.
Сначала определите, какой 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.
Проверяйте от простого к рабочему сценарию
- Сохраните версию клиента, базовый адрес, ID модели и дату проверки. Создайте отдельный тестовый ключ с ограничениями, которые предлагает поставщик.
- При наличии операции списка моделей проверьте точный ID. Не считайте отсутствие списка окончательным доказательством отсутствия генерации.
- Отправьте один короткий текстовый запрос без дополнительных параметров. Сохраните HTTP-статус, request ID, usage и фактическое списание, если оно доступно.
- Добавляйте по одной необходимой функции: сначала поток, затем JSON, затем инструмент. Так видно, какой параметр изменил поведение.
- Повторите полный сценарий приложения на вымышленных данных. Для инструмента это включает его результат и следующий ответ модели.
- Сверьте бюджет и обработку ошибок. Полный цикл может включать несколько оплачиваемых вызовов.
Не переносите рабочий ключ или реальные клиентские документы в онлайн-«тестеры API». Подключение проверяется вашим приложением или доверенным локальным инструментом.
Диагностика ошибок
| Ответ | Возможная причина | Следующее действие |
|---|---|---|
| 401/403 | Неверный ключ, права или ограничения доступа | Сверить хост, credential и правила аккаунта |
| 404 | Неверный путь либо неизвестная модель | Разделить проверку URL и поля model |
| 400 | Неподдерживаемый параметр или неверное тело | Свести запрос к минимальному и читать описание ошибки |
| 429 | Лимит нагрузки или квоты | Проверить вид ограничения |
| 200, но клиент не показывает ответ | Несовпадение формата ответа или событий | Проверить сырой ответ без публикации секретов |
HTTP 200 не гарантирует завершённый поток: Anthropic прямо описывает ошибки после начала SSE-ответа. Проверяйте итоговое событие и ошибки клиента.
Как сравнить предложения после проверки
Сначала оставьте варианты, которые поддерживают вашу задачу. Затем сравните стоимость одинаковых входа, выхода, кеша и инструментов. Иначе дешёвый текстовый тариф окажется рядом с предложением, которое выполняет больше работы.
Неизвестную поддержку помечайте «не подтверждена», а не «нет» или «работает». Сохраните матрицу рядом с конфигурацией: смена модели, версии SDK или маршрута требует повторной проверки нужных строк.
Для настройки автоматизации используйте инструкцию n8n. Работа со структурированными данными разобрана в статье о JSON Schema. Актуальные опубликованные цены и условия оплаты сравнивайте в каталоге.
