NormaHub

Провайдер · Google

Gemini через API из России

Модели Gemini через один ключ NormaHub: единый OpenAI-совместимый формат запросов, рублёвый баланс и стабильная работа без VPN. Точные ID моделей и их тарифы — в каталоге моделей.

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

Создать API key

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

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

  1. 01

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

  2. 02

    Направьте клиент на https://api.normahub.cc/v1 и подставьте MODEL_ID из каталога.

  3. 03

    Отправьте первый запрос и сверьте расход в истории по ключу.

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

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

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

Python · Gemini через NormaHub
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["NORMAHUB_API_KEY"],
    base_url="https://api.normahub.cc/v1",
)

response = client.chat.completions.create(
    model="MODEL_ID_GEMINI",  # ID из каталога /models
    messages=[{"role": "user", "content": "Привет!"}],
    max_tokens=256,
)
print(response.choices[0].message.content)
Модели Gemini в привычном формате Chat Completions.
Один ключ и баланс на все семейства моделей.
Оплата рублями, доступ из России без VPN.

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

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

Почему напрямую сложнее

Прямая работа с Google AI упирается в оплату: нужна зарубежная карта, российские карты не принимаются, а доступ к кабинету и биллингу из России может требовать обходных путей. Валютные счета и отдельные лимиты добавляют операционной нагрузки каждой команде. Через NormaHub всё сводится к одному ключу и рублёвому балансу, а endpoint доступен из России напрямую без VPN. Один ключ закрывает и остальные семейства, поэтому разрозненные кабинеты больше не нужны.

Какие задачи закрывает семейство Gemini

Gemini — универсальные модели для диалогов и ассистентов, генерации и редактуры текстов, кода, а также разбора документов и мультимодальных задач. Лёгкие модели берут массовые и фоновые задачи, флагманы — сложные рассуждения и длинные контексты. Точный список доступных моделей и тарифы обновляются, поэтому ID всегда берите из каталога моделей.

Как переключаться внутри семейства

Меняется только MODEL_ID в запросе: base_url, ключ и формат остаются прежними. Держите в конфиге два ID — быстрый и флагманский, — направляйте простые задачи экономичной модели, а сложные сильной. Перед масштабированием сверьте расход в истории запросов и задайте лимиты на ключи, чтобы эксперименты не вышли за бюджет. Сравнение расхода по ключам покажет, какая задача сколько стоит.

Где Gemini окупается в проде

Gemini закрывает сценарии с объёмным контекстом: разбор документов, сводки переписок, ответы поверх базы знаний, где в запрос уходит много текста. Рядом — массовые фоновые задачи: классификация, извлечение полей, черновики, где решает пропускная способность за рубль. Держите в конфиге два ID из каталога — быстрый для потока и сильный для сложных разборов, — и разводите задачи простым правилом. Раз в месяц сверяйте расход по ключам с качеством ответов: модели и тарифы обновляются, граница между быстрой и сильной должна двигаться вслед за ними.

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

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

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

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

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

Что такое Gemini через NormaHub?

Доступ к моделям семейства Gemini по единому OpenAI-совместимому API: один ключ, один base_url и оплата с рублёвого баланса.

Сколько стоят запросы к Gemini?

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

Где взять API-ключ?

В личном кабинете NormaHub: создайте ключ, пополните баланс рублями и храните ключ только в переменной окружения.

Запрос завершился ошибкой — что делать?

Проверьте MODEL_ID по каталогу, баланс ключа и формат запроса, затем сверьтесь с разбором ошибок и минимальным примером из гайда по Python.

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

Нет. Endpoint и рублёвая оплата доступны из России напрямую.

Можно ли получать ответы Gemini по частям?

Да, через потоковый режим Responses API у моделей, заявляющих этот маршрут: события SSE прилетают по мере генерации, интерфейс оживает без ожидания полного ответа. Для /v1/chat/completions поток в текущей версии не включён. Буфер чтения, обрывы и таймауты разобраны в гайде по streaming.