NormaHub

Единый API

Все нейросети по одному ключу

GPT, Claude и другие модели через один OpenAI-compatible endpoint: один баланс, один формат запросов, переключение моделей одной строкой.

Для кого: разработчики, команды и продукты, которым нужны несколько моделей без пяти кабинетов

Создать API key

Быстрый старт

От ключа до первого ответа

  1. 01

    Создайте ключ и пополните баланс рублями.

  2. 02

    Возьмите model ID из каталога.

  3. 03

    Меняйте модель одной строкой, остальной код не трогайте.

Рабочий шаблон

Скопируйте основу и замените модель

Используйте только идентификатор из актуального каталога. Ключ храните в переменной окружения.

Python · переключение моделей
import os
from openai import OpenAI

# Один клиент, один ключ, один base_url —
# модели меняются одной строкой
client = OpenAI(
    api_key=os.environ["NORMAHUB_API_KEY"],
    base_url="https://api.normahub.cc/v1",
)

for model in ["MODEL_ID_FAST", "MODEL_ID_PRO"]:
    response = client.chat.completions.create(
        model=model,
        messages=[{"role": "user", "content": "Привет"}],
        max_tokens=256,
    )
    print(model, "->", response.choices[0].message.content)
Один base URL вместо пяти интеграций.
Единый баланс и история всех запросов.
Лимиты на каждый ключ для команды и агентов.

Детали решения

Как это устроено

Один ключ вместо пяти кабинетов

Прямая работа с провайдерами — это пять аккаунтов, пять валют, пять способов оплаты и пять биллингов: OpenAI не принимает карты РФ, Anthropic закрыт по региону, у каждого свои SDK и лимиты. Единый gateway сводит всё к одному ключу и одному балансу: регистрация за минуты, пополнение рублями, а смена модели — параметр model в запросе, а не новая интеграция.

Как выбирать модель под задачу

Правило простое: дешёвые быстрые модели — на классификацию, черновики и диалоги; флагманы — на код, агентов и сложные рассуждения; image и video — на генерацию контента. Точные цены входа и выхода каждой модели — в каталоге, а посчитать месячный бюджет под вашу нагрузку помогает калькулятор на странице моделей. Разумная архитектура — роутер: простая задача уходит дешёвой модели, сложная — сильной.

Команда на одном балансе

Каждому направлению — свой ключ с лимитом: backend, бот, агент, эксперименты. Видно, кто сколько потратил; отзыв одного ключа не останавливает остальных. Общие лимиты защищают от забытых циклов и атак, а история запросов с usage даёт фактуру для оптимизации: какая фича сколько стоит.

Оплата и доступ из России

Запросы списываются с предоплаченного рублёвого баланса по тарифам каталога: вход и выход считаются отдельно за миллион токенов. Минимум и комиссия зависят от способа пополнения и видны перед счётом. VPN не нужен ни коду, ни оплате — endpoint доступен из России напрямую.

Миграция за вечер

План переезда существующего продукта: заведите ключ и пополните баланс, замените base_url и model ID в одном месте, прогоните smoke-тест из коротких запросов по каждой используемой модели, сверьте usage и суммы в истории, затем переключайте трафик и ставьте лимиты на ключи. Откат — возврат прежнего base_url, поэтому риск миграции минимален.

Оплата и контроль расходов

Запросы оплачиваются с предварительно пополненного баланса по актуальным ставкам выбранной модели. Минимум и комиссия показываются перед оплатой в кабинете; лимит расходов задаётся для API-ключа.

Ограничения доступности

Возможности зависят от модели и внешнего маршрута. При недоступности provider запрос может завершиться ошибкой; проверяйте каталог, статус и документацию перед production.

Частые вопросы

Чем единый API лучше прямых кабинетов?

Одним ключом, одним балансом и одним форматом запросов вместо пяти аккаунтов, валют и интеграций. Переключение моделей — одна строка кода.

Какие модели доступны?

GPT, Claude и другие текстовые, кодовые, image и video модели из актуального каталога. Список и цены — на странице моделей, точные ID — ответом /v1/models.

Как считается стоимость?

Входные и выходные токены — отдельно по ставкам модели за миллион. Финальная сумма каждого запроса сохраняется в истории личного кабинета.

Подойдёт ли команде?

Да: отдельные ключи с лимитами на направления, общий баланс, история usage по каждому запросу. Детали интеграции — в документации API.

Нужны ли VPN и зарубежная карта?

Нет. Доступ из России прямой, оплата — рублями с баланса личного кабинета.