Провайдер · Google

Gemini API из России

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

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

# один запрос, чтобы убедиться, что всё работает

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 в каталоге семь типов моделей — больше, чем у любого другого вендора. Видео и музыка отдаются через общий эндпоинт медиа, остальное — по своим адресам в формате OpenAI.

Чат-модели

23

Gemini 3.8 Flash, Gemini 3.7 Flash, Gemini 3.6 Flash

/chat/completions

Генерация изображений

5

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)

/images/generations

Генерация видео

4

Gemini Omni 1.1 Flash, Gemini Omni Video, Veo 3.1 Fast

/media

Генерация музыки

2

Lyria 3 Pro Preview, Lyria 3 Clip Preview

/media

Распознавание речи

1

Chirp 3

/audio/transcriptions

Синтез речи

3

Gemini 3.8 Flash TTS, Gemini 3.8 Flash Lite TTS, Gemini 3.1 Flash TTS Preview

/audio/speech

Эмбеддинги

1

Gemini Embedding 2 Preview

/embeddings

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

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

Регион не поддерживается

Gemini API отдаёт отказ по региону раньше, чем дело доходит до оплаты. Одной картой тут не обойтись — нужен ещё и адрес за пределами России.

Google Cloud тянет за собой проект

Ключ выдаётся не сам по себе: нужен проект в Cloud, биллинг-аккаунт и привязанная карта. Для одной модели это много лишних шагов.

Нечего показать бухгалтерии

Оплата зарубежной картой не закрывается документами. Для юрлица это расход, который нельзя провести.

Один вендор — один запасной путь

Когда у провайдера деградация, переключиться некуда: другой вендор — это другой ключ, другой SDK и другой договор.

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

Аккаунт у Google для этого не нужен: ключ выпускается в кабинете Polza и работает сразу со всеми вендорами каталога.

  1. 1

    Зарегистрируйтесь

    Почта и пароль. Телефон другой страны и зарубежная карта не нужны.

  2. 2

    Создайте ключ

    Раздел «API-ключи» в кабинете. Ключ начинается с pza_ — скопируйте его сразу, второй раз он не показывается. Ключей можно завести несколько: по одному на сервис или на сотрудника.

  3. 3

    Пополните баланс

    Карта РФ, СБП или счёт для юрлица. Минимальное пополнение — 100 ₽, этого хватает на 12 403 запроса к самой дешёвой модели Google.

  4. Получить 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/openaihttps://polza.ai/api/v1
Переменная с ключом$GOOGLE_API_KEY$POLZA_API_KEY
Идентификатор моделиgemini-3.8-flashgoogle/gemini-3.8-flash

Пути после базового адреса стандартные. У моделей Google задействованы: /audio/speech, /audio/transcriptions, /chat/completions, /embeddings, /images/generations, /media.

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

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

было · 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

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

13

Вызов функций

Модель сама решает, когда дёрнуть вашу функцию, и передаёт аргументы.

tools

20

Строгий JSON

Ответ приходит по заданной схеме — без парсинга текста регулярками.

response_format

15

Рассуждение

Промежуточные шаги считаются отдельно и приходят отдельным полем.

reasoning

21

Картинка на входе

В сообщение можно положить изображение вместе с текстом.

vision

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

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

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

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

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

Модели и цены

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

МодельТипКонтекстВход · 1MВыход · 1M
google/gemini-3.1-pro-previewСтаршая модель: сложные задачи, контекст миллионЧат-модели1 048 576114 ₽799 ₽
google/gemini-3.8-flashРабочая лошадка, в два с половиной раза дешевле ProЧат-модели1 048 57644,37 ₽222 ₽
google/gemini-3.1-flash-liteМассовые задачи и классификацияЧат-модели1 048 57614,79 ₽88,75 ₽
google/gemini-2.5-flash-liteСамая дешёвая из GeminiЧат-модели1 048 5765,92 ₽23,67 ₽
google/gemma-4-31b-itОткрытые веса Google, без ограничений вендораЧат-модели262 1449,47 ₽35,5 ₽
google/gemma-3-27b-itОткрытая модель, данные хранятся в РФЧат-модели128 0003,55 ₽13,02 ₽
google/gemini-3.1-flash-imageNano Banana 2 — генерация и правка картинокГенерация изображений131 07259,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 19259,16 ₽1 065 ₽
google/gemini-embedding-2-previewЭмбеддинги для поиска и RAGЭмбеддинги8 19223,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, обновлено . Цены и состав каталога меняются — на странице они из каталога и обновляются каждый час.

Сайт использует cookie.