Как подключить OpenAI-compatible API
Если приложение уже использует OpenAI SDK, для первого запроса обычно достаточно заменить base URL, ключ и model ID. Совместимость относится к формату API, но не обещает одинаковое поведение всех моделей.
Короткий ответ
Для первого запроса обычно хватает замены base URL, ключа и model ID — но формат не гарантирует одинакового поведения моделей.
Проверьте контракт до кода
Откройте публичный каталог или запросите список моделей ключом, который будет использовать приложение. Сверьте точный model ID, нужный endpoint и capabilities. Одна модель может поддерживать Chat Completions, а другая только отдельный маршрут или другой формат streaming.
Не переносите model ID из чужого README. Модель могла быть переименована, отключена или быть доступна только для другого ключа. Если каталог не разрешает маршрут, изменение prompt это не исправит.
- проверить model ID
- сверить endpoint
- проверить лимит контекста
- не путать Responses и Chat Completions
Минимальный запрос
Для OpenAI-compatible клиентов NormaHub используется base URL https://api.normahub.cc/v1. Ключ передавайте в Authorization: Bearer и храните на backend или в переменной окружения. В клиентский JavaScript постоянный ключ не добавляйте.
Начните с короткого запроса без tools, файлов и большого контекста. Зафиксируйте HTTP-статус, фактическую модель и X-Request-Id. Такой smoke-тест быстрее показывает, где находится ошибка: в ключе, маршруте или содержимом запроса.
- base URL: https://api.normahub.cc/v1
- model берётся из актуального каталога
- первый запрос должен быть маленьким
Подготовка к рабочей нагрузке
После короткого ответа проверьте сценарий с реальным размером контекста и ожидаемой длиной результата. Задайте собственный timeout, ограничьте число повторов и сохраните request ID в журнале приложения. Повторяйте только временные ошибки, а не 401, 403 или недостаточный баланс.
В личном кабинете Нормахаб (NormaHub) сопоставьте запрос с usage и итоговой стоимостью. До этого момента не считайте интеграцию принятой: успешный HTTP-ответ ещё не доказывает корректность биллинга и обработки ошибок.
Источники и связанные страницы
Следующий шаг
Открыть эту статью в Markdown·Поделиться в Telegram
Следующий материалКак выбрать AI API-провайдера для продукта