Gemini API в России — ключ и оплата в рублях

Что такое Gemini API

Gemini API (по-русски его часто пишут «гемини апи») — программный интерфейс к моделям Google. Через него приложения генерируют текст, разбирают изображения, создают картинки моделями Nano Banana и видео моделями Veo. Открытые модели Gemma доступны по тому же ключу.

ProxyAPI работает как посредник: приложение отправляет запрос на российский адрес https://api.proxyapi.ru, оттуда он уходит к Google через цепочку прокси-серверов в Европе, а ответ возвращается в том виде, в котором его отдал Google. Аккаунт в Google и VPN не нужны.

Как получить API-ключ Gemini

1. Зарегистрироваться в личном кабинете и подтвердить почту по ссылке из письма.
2. Создать ключ в разделе «Ключи API». Ключ начинается с sk- и показывается целиком только один раз, поэтому его стоит сразу сохранить.
3. Пополнить баланс. Пока он пуст, запросы возвращают ошибку о недостатке средств.

Одного ключа достаточно для всего каталога: те же реквизиты подходят для моделей OpenAI, Anthropic и DeepSeek. Для ключа можно ограничить список доступных моделей, задать бюджет и белый список IP — подробнее в статье API-ключи.

Оплата в рублях

Баланс пополняется банковской картой или через СБП, деньги зачисляются сразу после оплаты. Юридические лица оплачивают по счёту, который формируется в кабинете после регистрации договора; предоставляются закрывающие документы и доступен электронный документооборот.

Цены моделей Gemini фиксированы в рублях и включают НДС. Миллион токенов в каталоге — единица измерения, а не пакет: списывается ровно израсходованное, без округления. Подписок, предоплаченных пакетов и обязательного ежемесячного платежа нет. Как считается стоимость и как настроить автопополнение — в статье Баланс и пополнение.

Пример запроса к Gemini API

Официальная библиотека Google google-genai работает без изменений кода, кроме базового адреса и ключа. Ключ читается из переменной окружения PROXY_API_KEY.

pythoncurlnode.js
import os
from google import genai

client = genai.Client(
    api_key=os.environ["PROXY_API_KEY"],
    http_options={"base_url": "https://api.proxyapi.ru"},
)

response = client.models.generate_content(
    model="gemini-3.5-flash",
    contents="Назови столицу Австралии.",
)

print(response.text)

В формате Google имя модели стоит в адресе и пишется коротко, без вендора: gemini-3.5-flash. Эндпоинты, авторизация и устройство запроса разобраны в статье Формат Google Gemini.

Если код уже написан под библиотеку OpenAI, те же модели доступны на https://api.proxyapi.ru/v1 — тогда идентификатор указывается полностью, например google/gemini-3.5-flash. Как устроены идентификаторы, описано в статье Модели. Для работы в терминале есть отдельная инструкция по Gemini CLI.