# Gemini API из России

> Самый широкий набор в каталоге: текст, изображения, видео, музыка, речь и эмбеддинги — всё от Google и всё по одному ключу. Контекст до 1 048 576 токенов, оплата в рублях.

- Gemini, Gemma, Veo, Lyria
- Работает из РФ без VPN
- Карта РФ, СБП и счёт для юрлиц
- OpenAI-совместимый формат

- Моделей Google в каталоге: 39
- Типов задач: 7
- Максимальный контекст: 1 048 576 токенов
- Вход от 2,02 ₽ за 1M токенов

## Что доступно по ключу

У Google в каталоге семь типов моделей — больше, чем у любого другого вендора. Видео и музыка отдаются через общий эндпоинт медиа, остальное — по своим адресам в формате OpenAI.

- **Чат-модели** — 22, эндпоинт `/chat/completions`: Gemini 3.8 Flash, Gemini 3.7 Flash, Gemini 3.6 Flash
- **Генерация изображений** — 5, эндпоинт `/images/generations`: Nano Banana 2 Lite (Gemini 3.1 Flash Lite Image), Nano Banana 2 (Gemini 3.1 Flash Image), Nano Banana 2 (Gemini 3.1 Flash Image Preview)
- **Генерация видео** — 4, эндпоинт `/media`: Gemini Omni 1.1 Flash, Gemini Omni Video, Veo 3.1 Fast
- **Генерация музыки** — 2, эндпоинт `/media`: Lyria 3 Pro Preview, Lyria 3 Clip Preview
- **Распознавание речи** — 1, эндпоинт `/audio/transcriptions`: Chirp 3
- **Синтез речи** — 3, эндпоинт `/audio/speech`: Gemini 3.8 Flash TTS, Gemini 3.8 Flash Lite TTS, Gemini 3.1 Flash TTS Preview
- **Эмбеддинги** — 2, эндпоинт `/embeddings`: Gemini Embedding 2 Preview, Gemini Embedding 001

## Почему напрямую не выходит

Технически API открыт всем. Упирается всё в оплату и в адрес, с которого приходит запрос.

- **Регион не поддерживается.** Gemini API отдаёт отказ по региону раньше, чем дело доходит до оплаты. Одной картой тут не обойтись — нужен ещё и адрес за пределами России.
- **Google Cloud тянет за собой проект.** Ключ выдаётся не сам по себе: нужен проект в Cloud, биллинг-аккаунт и привязанная карта. Для одной модели это много лишних шагов.
- **Нечего показать бухгалтерии.** Оплата зарубежной картой не закрывается документами. Для юрлица это расход, который нельзя провести.
- **Один вендор — один запасной путь.** Когда у провайдера деградация, переключиться некуда: другой вендор — это другой ключ, другой SDK и другой договор.

## Адреса API

Слева то, что вы прописали бы при прямом доступе к Google, справа — что поставить вместо этого.

|  | Google напрямую | Через Polza.AI |
| --- | --- | --- |
| Базовый адрес | https://generativelanguage.googleapis.com/v1beta/openai | https://polza.ai/api/v1 |
| Переменная с ключом | $GOOGLE_API_KEY | $POLZA_API_KEY |
| Идентификатор модели | gemini-3.8-flash | google/gemini-3.8-flash |

## Что меняется в коде

Две строки: адрес и идентификатор модели. Клиент остаётся тот же, версию библиотеки менять не нужно.

было · generativelanguage.googleapis.com:

```
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["GOOGLE_API_KEY"],
    base_url="https://generativelanguage.googleapis.com/v1beta/openai",
)

resp = client.chat.completions.create(
    model="gemini-3.8-flash",
    messages=[{"role": "user", "content": "Привет"}],
)
```

стало · polza.ai:

```
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["POLZA_API_KEY"],
    base_url="https://polza.ai/api/v1",
)

resp = client.chat.completions.create(
    model="google/gemini-3.8-flash",
    messages=[{"role": "user", "content": "Привет"}],
)
```

Ключ берётся в кабинете. Если клиент всё равно ходит на старый адрес — проверьте переменные `GOOGLE_API_KEY` и `GEMINI_API_KEY`: они перебивают то, что передано в коде.

## Что умеет API

- Вызов функций (tools): 15
- Строгий JSON (response_format): 22
- Рассуждение (reasoning): 17
- Картинка на входе (vision): 21

## Есть ли бесплатный доступ

Бесплатного тарифа нет — платите за токены. Но порог низкий: минимальное пополнение 100 ₽. Ниже видно, во что это выходит на практике.

| Модель | Один запрос | 1 000 запросов | Запросов на 100 ₽ |
| --- | --- | --- | --- |
| google/gemma-3-27b-it | 0,01 ₽ | 13,61 ₽ | 7 348 |
| google/gemini-3.1-flash-lite | 0,07 ₽ | 73,96 ₽ | 1 352 |
| google/gemini-3.1-pro-preview | 0,63 ₽ | 628 ₽ | 159 |

За запрос считаем 2 000 токенов на входе и 500 на выходе — это примерно страница текста в вопросе и абзац в ответе.

Отдельно про «бесплатные ключи», которые раздают в каналах и на форумах: это либо чужой ключ, либо прокси поверх чужого. Работает до первой блокировки, а промпты при этом уходят неизвестно куда. Для рабочего проекта не годится.

## Модели и цены

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

| Модель | Тип | Контекст | Вход · 1M | Выход · 1M |
| --- | --- | --- | --- | --- |
| [google/gemini-3.1-pro-preview](https://polza.ai/models/google/gemini-3.1-pro-preview.md) — Старшая модель: сложные задачи, контекст миллион | Чат-модели | 1 048 576 | 114 ₽ | 799 ₽ |
| [google/gemini-3.8-flash](https://polza.ai/models/google/gemini-3.8-flash.md) — Рабочая лошадка, в два с половиной раза дешевле Pro | Чат-модели | 1 048 576 | 44,37 ₽ | 222 ₽ |
| [google/gemini-3.1-flash-lite](https://polza.ai/models/google/gemini-3.1-flash-lite.md) — Массовые задачи и классификация | Чат-модели | 1 048 576 | 14,79 ₽ | 88,75 ₽ |
| [google/gemini-2.5-flash-lite](https://polza.ai/models/google/gemini-2.5-flash-lite.md) — Самая дешёвая из Gemini | Чат-модели | 1 048 576 | 5,92 ₽ | 23,67 ₽ |
| [google/gemma-4-31b-it](https://polza.ai/models/google/gemma-4-31b-it.md) — Открытые веса Google, без ограничений вендора | Чат-модели | 262 144 | 9,47 ₽ | 35,5 ₽ |
| [google/gemma-3-27b-it](https://polza.ai/models/google/gemma-3-27b-it.md) — Открытая модель, данные хранятся в РФ | Чат-модели | 128 000 | 3,55 ₽ | 13,02 ₽ |
| [google/gemini-3.1-flash-image](https://polza.ai/models/google/gemini-3.1-flash-image.md) — Nano Banana 2 — генерация и правка картинок | Генерация изображений | 131 072 | 59,16 ₽ | 355 ₽ |
| [google/veo3](https://polza.ai/models/google/veo3.md) — Veo 3.1 Quality — видео по тексту | Генерация видео | — | — | — |
| [google/veo3_fast](https://polza.ai/models/google/veo3_fast.md) — Тот же Veo, быстрее и дешевле | Генерация видео | — | — | — |
| [google/lyria-3-pro-preview](https://polza.ai/models/google/lyria-3-pro-preview.md) — Генерация музыки | Генерация музыки | 1 048 576 | — | — |
| [google/chirp-3](https://polza.ai/models/google/chirp-3.md) — Распознавание речи | Распознавание речи | — | — | — |
| [google/gemini-3.8-flash-tts](https://polza.ai/models/google/gemini-3.8-flash-tts.md) — Озвучка текста | Синтез речи | 8 192 | 59,16 ₽ | 1 065 ₽ |
| [google/gemini-embedding-2-preview](https://polza.ai/models/google/gemini-embedding-2-preview.md) — Эмбеддинги для поиска и RAG | Эмбеддинги | 8 192 | 23,67 ₽ | — |

## Прямой доступ и доступ через Polza

|  | Google напрямую | Через Polza.AI |
| --- | --- | --- |
| Оплата | Зарубежная карта | Карта РФ, СБП, счёт для юрлица |
| Доступ из России | Отказ по региону | Напрямую |
| Документы | Инвойс на английском | Договор с ООО, УПД и НДС |
| Цены | В долларах | В рублях, списание с баланса |
| Модели других вендоров | Отдельный договор и ключ | Тот же ключ, 419 моделей |
| Если модель отвалилась | Ждать | Поменять строку с моделью |
| Код | Openai-совместимый sdk | Тот же SDK, другой Base URL |

## Если не работает

6 причин, на которые приходится почти вся переписка с поддержкой: сначала коды ответов, потом то, что встречается именно с Google.

- **401 Unauthorized или Invalid API key.** Ключ скопирован не целиком или взят из другого проекта. Рабочий ключ начинается с `pza_` и передаётся заголовком `Authorization: Bearer pza_...`. Старый ключ вендора здесь не подойдёт.
- **402 или «недостаточно средств».** Кончился баланс. Он общий на все модели и не сгорает — пополните в кабинете картой, через СБП или по счёту, ключ менять не нужно.
- **404 на модели.** Забыт префикс вендора. Не `gemini-3.8-flash`, а `google/gemini-3.8-flash` — идентификатор целиком, как в каталоге. Проверить написание можно запросом к `/api/v1/models`.
- **429 Too Many Requests.** Слишком много запросов в секунду к конкретной модели. Это ограничение вендора, а не баланса: помогает повтор с задержкой или переключение на соседнюю модель в той же линейке.
- **Не работает google-genai.** Родная библиотека Google ходит на свои адреса и подключение через шлюз не поддерживает. Берите OpenAI-совместимый клиент — формат запросов тот же.
- **Видео или музыка не отдаются сразу.** Veo и Lyria работают через `/media`: задача ставится в очередь, результат забирается отдельным запросом. Это не ошибка, а другой формат.

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

### Чем Gemini отличается от GPT?

Контекстом и мультимодальностью. У Gemini 1 048 576 токенов и родная работа с видео и аудио на входе. На длинных документах это заметно.

### Veo 3 правда доступен?

Да, в каталоге две версии: veo3 и veo3_fast. Генерация ставится в очередь через эндпоинт медиа, оплата идёт с общего баланса.

### Что такое Nano Banana?

Так называют модель Gemini Flash Image. В каталоге она под идентификатором google/gemini-3.1-flash-image, есть и облегчённая Lite-версия.

### Gemma — это то же самое?

Нет. Gemma — открытые модели Google, их можно запускать где угодно. В каталоге они дешевле Gemini, а у gemma-3-27b-it стоит отметка о хранении данных в РФ.

### Нужен ли VPN?

Нет. Запросы идут на polza.ai, российские адреса не блокируются.

### Можно оплатить по счёту?

Да. Для ООО и ИП — счёт, договор с российским юрлицом и закрывающие документы каждый месяц. Ключи выдаются на сотрудников, баланс общий.

### А другие вендоры?

Тот же ключ открывает 419 моделей. Чтобы уйти с Google на другого вендора, достаточно поменять строку с идентификатором модели.

## Ссылки

- Документация: https://polza.ai/docs
- Каталог моделей: https://polza.ai/models/llms.txt
- Страница: https://polza.ai/providers/google
- Обновлено: 2026-09-29