Gemini API vs Vertex API: в чём разница и что выбрать разработчику

Разработчики, которые впервые подключают Gemini, натыкаются на два названия: Gemini API и Vertex AI. Оба дают доступ к одним и тем же семействам моделей, но устроены по-разному. Ниже сравнение Gemini API vs Vertex API по пунктам, которые влияют на работу: авторизация, оплата, регионы, SDK. В конце показываю третий вариант, когда не хочется заводить ни AI Studio, ни облачный проект.

Сверка сделана по документации Google на момент написания (18 октября 2026). Google иногда переименовывает продукты: в свежих материалах «Vertex» всё чаще называется Gemini platform, а в списке регионов встречается Gemini Enterprise Agent Platform. В примерах SDK для generate_content облачная сторона включается параметром vertexai=True, а в новых примерах Interactions API Google использует enterprise=True; сверяйтесь с документацией своей версии SDK. В статье я называю эту сторону Vertex, как привыкли разработчики.

Что это за два продукта

Gemini Developer API (его же называют Gemini API) работает по ключу, который выдаёт Google AI Studio. Документация Google прямо советует его большинству разработчиков, если нет особых корпоративных требований.

Vertex AI живёт внутри Google Cloud. Там нужен облачный проект, платёжный аккаунт, права доступа через IAM и сервисные аккаунты. Взамен вы получаете корпоративные возможности облака: единое управление правами, аудит, привязку к проектам организации.

Оба продукта доступны через единый SDK google-genai. Разница заметна уже при создании клиента:

from google import genai

USE_VERTEX = False

if USE_VERTEX:
    # Vertex: облачный проект и регион
    client = genai.Client(vertexai=True, project="your-project-id", location="us-central1")
else:
    # Gemini Developer API: ключ из AI Studio (обычно в переменной окружения)
    client = genai.Client()

response = client.models.generate_content(
    model="gemini-3.8-flash",
    contents="Объясни разницу между list и tuple в Python",
)
print(response.text)

Остальной код после создания клиента одинаковый. Именно поэтому переезд между двумя сторонами Google обычно сводится к смене способа авторизации.

Gemini API vs Vertex API: сводная таблица

Что важно знать про каждый пункт.

Биллинг. По документации Google, новые аккаунты Gemini Developer API начинают с бесплатного уровня. Для платного нужно привязать биллинг-аккаунт и внести минимум $5 (или эквивалент в другой валюте), дальше лимиты растут по уровням в зависимости от расхода. Условия меняются, поэтому актуальную схему смотрите на странице Billing в документации Google.

Регионы. Gemini API и AI Studio доступны только в странах из официального списка. Если вашей страны в нём нет, Google предлагает вариант через облачную платформу. На момент написания России в списке нет. Работа через Vertex требует облачного аккаунта и способа оплаты, а это отдельные вопросы со своими условиями. Заранее проверьте их на сайте Google.

Миграция. Google описывает переезд так: для Vertex понадобятся сервисные аккаунты, можно взять существующий облачный проект. Модели, которые вы дообучали в AI Studio, придётся обучать заново. Ключ Gemini API, который больше не нужен, рекомендуют удалить.

Третий путь: OpenAI-совместимый шлюз

Бывает, что ни ключ AI Studio, ни облачный проект не подходят: страна, способ оплаты или просто нежелание держать два аккаунта ради одной модели. Тогда остаётся шлюз с OpenAI-совместимым API. Через Zukko это выглядит так: один ключ fetch_..., один баланс в долларах, модели Gemini доступны как gemini-3.8-flash и gemini-3.7-flash.

from openai import OpenAI

client = OpenAI(
    base_url="https://api.zukko.pro/v1",
    api_key="fetch_ваш_ключ",
)

response = client.chat.completions.create(
    model="gemini-3.8-flash",
    messages=[{"role": "user", "content": "Объясни разницу между list и tuple в Python"}],
)
print(response.choices[0].message.content)

Тот же клиент и тот же ключ работают с Claude, GPT, DeepSeek, Qwen и GLM: меняется только строка model. Список актуальных моделей отдаёт GET https://api.zukko.pro/v1/models.

Доступ из России — через шлюз, оплата СБП (платёжная страница добавляет 8,5% сверху), картой MasterCard или криптой.

Что это даёт по цене

Цены на 18 октября 2026, доллары за 1M токенов. У gemini-3.8-flash в Zukko вход 0.125, выход 0.6, у поставщика по нашей таблице 0.75 и 3.75. Пример для объёма в 1M токенов входа и 200K токенов выхода (суммарно по серии запросов):

• в Zukko: 1 × 0.125 + 0.2 × 0.6 = 0.125 + 0.12 = $0.245;
• по официальным ценам из таблицы: 1 × 0.75 + 0.2 × 3.75 = 0.75 + 0.75 = $1.50.

Кэш тарифицируется отдельно: чтение кэша у Gemini 3.8 Flash стоит 0.013 за 1M, запись 0.125. Актуальные цены всегда на странице «Модели» в кабинете.

Что вы теряете

У шлюза есть цена в функциях. В формате chat/completions нет нативных возможностей Google, которые существуют только в их собственных API: Live API, Files API, привязка к поиску Google. Если они вам нужны, остаётся прямой Gemini API или Vertex. Кроме того, gemini-3.8-flash и gemini-3.7-flash в нашем каталоге принимают только текст на входе, без картинок. Для задач с изображениями смотрите другие модели в таблице: у claude-sonnet-5-5 и gpt-6.1-sol вход с картинками есть.

Как выбрать

1. Нужны корпоративные контроли облака (IAM, аудит, организации) и у вас есть облачный проект: Vertex.
2. Нужны нативные функции Gemini вроде Live API и ваша страна есть в списке Google: Gemini Developer API.
3. Нужен текстовый чат, классификация, извлечение данных или агент на Gemini 3.8 Flash, и вы хотите один ключ для всех моделей: шлюз.
4. Сомневаетесь: сначала проверьте задачу на своих данных. Сравните качество и цену на 20–30 реальных запросах, а не по рейтингам.

Подробнее про путь для России: Gemini в России через API↗ и Gemini 3.8 Flash через API↗. Про выбор между шлюзом и прямым доступом: шлюз или прямой API↗.

Ключ создаётся в кабинете↗, формат запросов и список моделей описаны в документации Zukko.

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

Gemini API и Vertex AI — это разные модели?

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

Можно ли написать код один раз и переключаться между ними?

Да, SDK google-genai поддерживает обе стороны, и меняется только создание клиента (genai.Client() или genai.Client(vertexai=True, ...)). Если нужен переключатель между разными провайдерами сразу, удобнее OpenAI-совместимый формат: меняется base_url и model.

Нужен ли Vertex для продакшена?

Не обязательно. Google советует Gemini Developer API большинству разработчиков и предлагает облачную сторону там, где нужны корпоративные контроли. Решать по требованиям вашей компании, а не по названию.

Как подключить Gemini через Zukko?

Создайте ключ в кабинете, укажите base_url="https://api.zukko.pro/v1" в OpenAI SDK и модель gemini-3.8-flash. Если запрос вернул 404, проверьте имя модели через GET /v1/models.