NormaHub
NormaHub knowledge base

Гайды по интеграции

Пошаговые сценарии для приложений и AI-агентов — от ключа и первого запроса до streaming, ошибок и стоимости.

Перед подключением

  1. 01

    Создайте API-ключ в личном кабинете.

  2. 02

    Получите ID модели через GET /v1/models.

  3. 03

    Храните ключ только в переменной окружения.

Выберите сценарий

OpenCode

Подключение NormaHub как OpenAI-compatible провайдера и безопасное хранение ключа.

OpenAI SDK

Выбор маршрута, настройка base URL и повторное использование привычного клиента.

Claude и Anthropic SDK

Подключение Claude-моделей через Messages API и отдельный base URL.

Python

Установка SDK, переменная окружения и первый запрос с backend или скрипта.

Node.js и TypeScript

Серверная интеграция, типичный запрос и безопасная работа с ключом.

Streaming Responses

SSE через Responses API, завершение потока и обработка разрыва соединения.

Ошибки API

Коды ошибок gateway, диагностика и политика безопасных повторов.

Стоимость токенов

Расчёт входа и выхода, лимиты и контроль итоговой стоимости.

Какой маршрут выбрать

Responses API

Новые интеграции и потоковые ответы через base URL с /v1.

Chat Completions

OpenAI-compatible клиенты и массив messages через base URL с /v1.

Messages API

Anthropic SDK и Claude-модели через base URL без /v1.

Перед реализацией проверьте endpoints выбранной модели. Полный контракт и форматы ошибок описаны в документации API.