GPT и Claude в одном проекте
Разные семейства моделей можно использовать в одном продукте, не смешивая их протоколы. Для GPT подходят OpenAI-compatible маршруты, а для Claude доступен Anthropic-compatible Messages API.
Два протокола, единая учётная запись
OpenAI-compatible SDK подключается к https://api.normahub.cc/v1. Официальный Anthropic SDK получает base URL https://api.normahub.cc без суффикса /v1 и самостоятельно добавляет путь /v1/messages.
API key передаётся как секрет приложения. Перед использованием запросите каталог моделей и убедитесь, что выбранная модель поддерживает нужный endpoint.
Разделяйте адаптеры в коде
Не привязывайте бизнес-логику напрямую к формату одного SDK. Выделите небольшой слой, который принимает задачу приложения и преобразует её в Chat Completions, Responses или Messages API.
- единый внутренний формат сообщения
- отдельный адаптер для каждого протокола
- явный выбор модели и маршрута
- общая обработка лимитов, стоимости и ошибок
Не переключайте модель незаметно
У моделей различаются поведение, длина контекста и стоимость. Если продукт допускает резервный сценарий, зафиксируйте разрешённые модели и сообщайте приложению о фактически использованной модели через журнал запроса.
Проверка интеграции
Протестируйте короткий ответ, длинный контекст, ошибочный ключ, недостаточный баланс и превышение лимита. Для потоковой генерации отдельно проверьте поддержку streaming выбранным маршрутом и моделью.