Как подключить OpenAI-compatible API
OpenAI-compatible API позволяет подключить AI-модель через привычные SDK и формат запросов. Для старта нужны базовый адрес, API key и идентификатор доступной модели.
Что подготовить перед подключением
Создайте API key в личном кабинете и храните его только на сервере или в переменной окружения. Не добавляйте ключ в клиентский JavaScript, публичный репозиторий или URL запроса.
Для OpenAI-compatible клиентов NormaHub используется base URL https://api.normahub.cc/v1. Актуальные идентификаторы моделей доступны через GET /v1/models и в личном кабинете.
- API key с активным балансом
- base URL https://api.normahub.cc/v1
- идентификатор модели из актуального каталога
Первый запрос
Для чатового сценария отправьте POST-запрос на /v1/chat/completions. Передайте ключ в заголовке Authorization, модель в поле model и историю диалога в массиве messages.
Ответ содержит сгенерированный текст и usage. В личном кабинете запрос появится с итоговым статусом, количеством токенов и финальной стоимостью с учётом применённых условий.
Что проверить перед production
Добавьте таймауты, ограниченное число повторов и журналирование X-Request-Id. Повторять запрос следует только после временных сетевых ошибок или ответа 503, используя безопасную стратегию повторов.
- не записывать API key и полный пользовательский ввод в технические логи
- обрабатывать 401, 402, 429 и 503 раздельно
- задавать разумный лимит выходных токенов
- сохранять X-Request-Id для диагностики