Gemini API из России
Самый широкий набор в каталоге: текст, изображения, видео, музыка, речь и эмбеддинги — всё от Google и всё по одному ключу. Контекст до 1 048 576 токенов, оплата в рублях.
- Gemini, Gemma, Veo, Lyria
- Работает из РФ без VPN
- Карта РФ, СБП и счёт для юрлиц
- OpenAI-совместимый формат
# один запрос, чтобы убедиться, что всё работает
curl https://polza.ai/api/v1/chat/completions \
-H "Authorization: Bearer $POLZA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "google/gemini-3.8-flash",
"messages": [{"role": "user", "content": "Привет"}]}'
- моделей Google
- 39
- типов задач
- 7
- токенов контекста
- 1 048 576
- за 1M токенов входа
- 2,02 ₽
Что доступно по ключу
У Google в каталоге семь типов моделей — больше, чем у любого другого вендора. Видео и музыка отдаются через общий эндпоинт медиа, остальное — по своим адресам в формате OpenAI.
Чат-модели
23Gemini 3.8 Flash, Gemini 3.7 Flash, Gemini 3.6 Flash
/chat/completions
Генерация изображений
5Nano 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)
/images/generations
Генерация видео
4Gemini Omni 1.1 Flash, Gemini Omni Video, Veo 3.1 Fast
/media
Генерация музыки
2Lyria 3 Pro Preview, Lyria 3 Clip Preview
/media
Распознавание речи
1Chirp 3
/audio/transcriptions
Синтез речи
3Gemini 3.8 Flash TTS, Gemini 3.8 Flash Lite TTS, Gemini 3.1 Flash TTS Preview
/audio/speech
Эмбеддинги
1Gemini Embedding 2 Preview
/embeddings
Почему напрямую не выходит
Технически API открыт всем. Упирается всё в оплату и в адрес, с которого приходит запрос.
Регион не поддерживается
Gemini API отдаёт отказ по региону раньше, чем дело доходит до оплаты. Одной картой тут не обойтись — нужен ещё и адрес за пределами России.
Google Cloud тянет за собой проект
Ключ выдаётся не сам по себе: нужен проект в Cloud, биллинг-аккаунт и привязанная карта. Для одной модели это много лишних шагов.
Нечего показать бухгалтерии
Оплата зарубежной картой не закрывается документами. Для юрлица это расход, который нельзя провести.
Один вендор — один запасной путь
Когда у провайдера деградация, переключиться некуда: другой вендор — это другой ключ, другой SDK и другой договор.
Как получить ключ
Аккаунт у Google для этого не нужен: ключ выпускается в кабинете Polza и работает сразу со всеми вендорами каталога.
- 1
Зарегистрируйтесь
Почта и пароль. Телефон другой страны и зарубежная карта не нужны.
- 2
Создайте ключ
Раздел «API-ключи» в кабинете. Ключ начинается с
pza_— скопируйте его сразу, второй раз он не показывается. Ключей можно завести несколько: по одному на сервис или на сотрудника. - 3
Пополните баланс
Карта РФ, СБП или счёт для юрлица. Минимальное пополнение — 100 ₽, этого хватает на 12 403 запроса к самой дешёвой модели Google.
- Получить API-ключДокументация
# ключ из кабинета начинается с pza_
export POLZA_API_KEY=pza_...
# один запрос — и видно, что ключ живой
curl https://polza.ai/api/v1/models \
-H "Authorization: Bearer $POLZA_API_KEY"Адреса 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 |
Пути после базового адреса стандартные. У моделей Google задействованы: /audio/speech, /audio/transcriptions, /chat/completions, /embeddings, /images/generations, /media.
Что меняется в коде
Две строки: адрес и идентификатор модели. Клиент остаётся тот же, версию библиотеки менять не нужно.
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": "Привет"}],
)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
Цифры — сколько моделей Google в каталоге поддерживают эту возможность. Считается по самому каталогу, а не заявлено на словах. Стриминг ответа работает везде.
Вызов функций
Модель сама решает, когда дёрнуть вашу функцию, и передаёт аргументы.
tools
Строгий JSON
Ответ приходит по заданной схеме — без парсинга текста регулярками.
response_format
Рассуждение
Промежуточные шаги считаются отдельно и приходят отдельным полем.
reasoning
Картинка на входе
В сообщение можно положить изображение вместе с текстом.
vision
Есть ли бесплатный доступ
Бесплатного тарифа нет — платите за токены. Но порог низкий: минимальное пополнение 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Старшая модель: сложные задачи, контекст миллион | Чат-модели | 1 048 576 | 114 ₽ | 799 ₽ |
| google/gemini-3.8-flashРабочая лошадка, в два с половиной раза дешевле Pro | Чат-модели | 1 048 576 | 44,37 ₽ | 222 ₽ |
| google/gemini-3.1-flash-liteМассовые задачи и классификация | Чат-модели | 1 048 576 | 14,79 ₽ | 88,75 ₽ |
| google/gemini-2.5-flash-liteСамая дешёвая из Gemini | Чат-модели | 1 048 576 | 5,92 ₽ | 23,67 ₽ |
| google/gemma-4-31b-itОткрытые веса Google, без ограничений вендора | Чат-модели | 262 144 | 9,47 ₽ | 35,5 ₽ |
| google/gemma-3-27b-itОткрытая модель, данные хранятся в РФ | Чат-модели | 128 000 | 3,55 ₽ | 13,02 ₽ |
| google/gemini-3.1-flash-imageNano Banana 2 — генерация и правка картинок | Генерация изображений | 131 072 | 59,16 ₽ | 355 ₽ |
| google/veo3Veo 3.1 Quality — видео по тексту | Генерация видео | — | — | — |
| google/veo3_fastТот же Veo, быстрее и дешевле | Генерация видео | — | — | — |
| google/lyria-3-pro-previewГенерация музыки | Генерация музыки | 1 048 576 | — | — |
| google/chirp-3Распознавание речи | Распознавание речи | — | — | — |
| google/gemini-3.8-flash-ttsОзвучка текста | Синтез речи | 8 192 | 59,16 ₽ | 1 065 ₽ |
| google/gemini-embedding-2-previewЭмбеддинги для поиска и RAG | Эмбеддинги | 8 192 | 23,67 ₽ | — |
Это выборка. Полный список — 39 моделей Google и ещё 384 модели у других вендоров — в каталоге.
Прямой доступ и доступ через Polza
| Google напрямую | Через Polza.AI | |
|---|---|---|
| Оплата | Зарубежная карта | Карта РФ, СБП, счёт для юрлица |
| Доступ из России | Отказ по региону | Напрямую |
| Документы | Инвойс на английском | Договор с ООО, УПД и НДС |
| Цены | В долларах | В рублях, списание с баланса |
| Модели других вендоров | Отдельный договор и ключ | Тот же ключ, 423 модели |
| Если модель отвалилась | Ждать | Поменять строку с моделью |
| Код | 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: задача ставится в очередь, результат забирается отдельным запросом. Это не ошибка, а другой формат.
Для команд и юрлиц
Счёт, УПД и НДС
Оплата по счёту для ООО и ИП, договор с российским юрлицом, закрывающие документы каждый месяц.
Ключ на сотрудника
Отдельные ключи с общим балансом организации: видно, кто и сколько потратил.
Контроль бюджета
Статистика расходов по ключам и моделям в кабинете, без сюрпризов в конце месяца.
Помощь с переездом
Поможем перевести команду с зарубежных подписок на API: настройка окружений и правила расходования.
Вопросы и ответы
Чем 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, российские адреса не блокируются.
Можно оплатить по счёту?
Да. Для ООО и ИП — счёт, договор с российским юрлицом и закрывающие документы каждый месяц. Ключи выдаются на сотрудников, баланс общий.
А другие вендоры?
Тот же ключ открывает 423 модели. Чтобы уйти с Google на другого вендора, достаточно поменять строку с идентификатором модели.
Работает там, где вы уже работаете
Редакторы, десктоп-клиенты, конструкторы сценариев и фреймворки. Ключ и баланс везде одни и те же, меняется только адрес API. На каждый инструмент есть разбор по шагам.
Подсвечены те, для которых эта страница подходит лучше всего. Остальные работают с тем же ключом.
Другие вендоры по тому же ключу
Менять договор и заводить второй ключ не нужно: вендор переключается строкой с идентификатором модели.
Кто проверял эту инструкцию

Руководитель техподдержки · редакция Polza.AI
Собрал и проверил подключение Google на актуальной версии: прошёл все шаги заново, сверил идентификаторы моделей с каталогом и перепроверил адреса API. Если API обновится и инструкция разойдётся с реальностью — правим страницу.
Обновлено · Как работает редакция · Нашли неточность? Напишите нам
Gemini, Veo и Lyria по одному ключу
Текст, картинки, видео и музыка от Google — без VPN, без зарубежной карты и без отдельного аккаунта в Google Cloud.
Остались вопросы? Документация Polza.AI, поддержка в Telegram или support@polza.ai
Страницу проверила редакция Polza.AI, обновлено . Цены и состав каталога меняются — на странице они из каталога и обновляются каждый час.