NormaHub knowledge base

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

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

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

  1. 01

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

  2. 02

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

  3. 03

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

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

Claude Code

Подключение Claude Opus, Sonnet и других моделей к AI-ассистенту от Anthropic.

Codex

Настройка NormaHub в Codex: GPT модели через единую конфигурацию TOML.

OpenCode

Подключение GPT и Claude моделей к OpenCode через OpenAI-compatible провайдера.

Cursor

Свой API-ключ в Cursor: Override Base URL, модели и кнопка Verify.

n8n

HTTP Request к NormaHub: авторизация, выражения и защита бюджета.

Telegram-бот

Backend держит ключ: история диалога, лимиты и обработка ошибок.

OpenAI SDK

Выбор маршрута, настройка 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.