Если прототип Gemini уже близок к запуску, не начинайте миграцию в корпоративную платформу только потому, что приложение становится "production". Сначала оставайтесь на Google AI Studio и Gemini Developer API, пока единственный реальный риск связан с обычной разработкой: запросы, ключи, биллинг, лимиты, владелец проекта, доступ к нужной модели или серверная интеграция. Платный Developer API закрывает многие такие задачи без перехода в полный Google Cloud-контур.
Переход к Gemini Enterprise Agent Platform и связанным сервисам Google Cloud нужен тогда, когда требование уже названо как корпоративный контроль: IAM, org policy, региональные или data controls, provisioned throughput, Model Garden, MLOps, частная сеть, централизованный security review, enterprise support, procurement или compliance. Старая формула "AI Studio для прототипа, Vertex AI для продакшна" полезна как первая подсказка, но она слишком быстро пропускает средний маршрут.
Быстрый выбор маршрута
| Что сейчас блокирует запуск | С чего начинать | Почему |
|---|---|---|
| Нужно быстро проверить prompt, response shape, function calling, structured output или backend prototype. | Google AI Studio + Gemini Developer API. | Google позиционирует Developer API как маршрут для большинства разработчиков, если не нужны конкретные enterprise controls. |
| Прототип работает, но дальше нужны quota, billing, project owner, paid model access или paid data-use terms. | Платный проект Gemini Developer API. | Это отдельный production-маршрут, а не автоматический повод для Vertex / enterprise migration. |
| Нельзя выпускать без IAM, org policy, regional/data controls, provisioned throughput, MLOps, Model Garden, VPC/security, support или compliance. | Gemini Enterprise Agent Platform / Google Cloud enterprise route. | Эти требования относятся к управлению платформой, а не к более "серьезному" API key. |
Главная ошибка - считать AI Studio игрушкой, а Vertex AI единственным правильным ответом для любого production. У платного Developer API есть собственная роль. Он дает проектный контекст, биллинг, более серьезные лимиты, владельцев, paid-tier поведение и границу использования данных, которая может быть достаточной для многих приложений.
Вторая ошибка - считать рабочий AI Studio key признаком готовности к запуску. Ключ доказывает только возможность аутентификации. Он не доказывает, что проект прошел проверку биллинга, live rate limits, data policy, endpoint choice, logging boundary, secret handling, retries и rollback plan.
Разведите названия по владельцам
Полезнее смотреть не на престиж названия, а на то, какая поверхность чем владеет.
| Название | Практический владелец | Для чего подходит | Чем не является |
|---|---|---|---|
| Google AI Studio | Browser surface для тестирования Gemini, создания ключей и работы с проектами. | Prompt testing, быстрые ключи, первые вызовы, просмотр проекта. | Гарантией всех моделей, регионов, квот и production policy. |
| Gemini Developer API | Прямой developer route на ai.google.dev. | Большинство app builds, SDK integrations, backend services, paid projects без enterprise controls. | Автоматическим IAM, data residency, MLOps или private networking. |
| Paid Developer API | Та же Developer API линия с billing и paid-tier поведением. | Обычное production давление: quota, billing, project ownership, paid data terms. | Заменой compliance architecture. |
| Vertex AI / enterprise platform | Google Cloud enterprise route, сейчас в документах ближе к Gemini Enterprise Agent Platform и Cloud AI сервисам. | Governance, regional/data controls, provisioned throughput, Model Garden, MLOps, support, compliance. | Ответом по умолчанию на любой production вопрос. |
| Gemini Enterprise app | Пользовательское enterprise-приложение. | Company knowledge, enterprise user access, internal workflows. | Синонимом Developer API или каждого Vertex AI API call. |
В документации Google по миграции Gemini API сейчас говорится о двух API products: Gemini Developer API и Gemini Enterprise Agent Platform API. Там же указано, что большинству разработчиков следует использовать Developer API, если не нужны конкретные enterprise controls. Это и есть центр решения.
Слово Vertex AI остается узнаваемым, потому что многие старые материалы, разработчики и Cloud-команды используют его как shorthand для корпоративной стороны. Но решение должно оставаться точным: direct Developer API first, paid Developer API for ordinary production pressure, enterprise platform for named enterprise controls.
Когда оставаться на Developer API
Оставайтесь на Google AI Studio и Gemini Developer API, если работа все еще app-shaped: нужно построить, протестировать и выпустить обычное Gemini-приложение без обязательного корпоративного контура.
Хорошие задачи для Developer API:
- prompt testing, structured output, function calling, multimodal checks;
- small или medium backend integration;
- работа с unified Google Gen AI SDK;
- проверка поведения модели перед product decision;
- внутренний prototype с понятным владельцем проекта;
- low-risk production service внутри допустимых billing, quota, logging и data-use terms;
- сервис, где ключи можно безопасно держать на сервере или в managed secrets.
Проверяйте не "production ли это", а какой риск остался нерешенным. Если риск звучит как "нужно больше quota", "кто платит за проект", "какой лимит сейчас действует", "какой model row доступен", "как настроить retries", то он ближе к Developer API. Если риск звучит как "security review требует org policy и data residency evidence", он уже ближе к enterprise platform.
Для узких задач лучше использовать отдельные маршруты. Создание ключа, первая команда, безопасное хранение и ошибки 403/429 относятся к Google AI Studio API key setup. Проверка бесплатного слоя, project-level limits, billing state и 429 относится к Gemini API free tier limits. Выбор платформы должен заниматься не setup-командами, а порогом миграции.
Когда сначала платить за Developer API
Paid Developer API - это маршрут, который часто теряется в двухколоночном сравнении.
| Production pressure | Платный Developer API может хватить, когда... | Enterprise route нужен, когда... |
|---|---|---|
| Billing | Нужен paid project, budget owner и более высокий usage tier. | Billing должен совпасть с procurement, enterprise discount, support или committed capacity. |
| Quota | Приложению нужны более высокие RPM, TPM, RPD или paid-tier behavior. | Нужен provisioned throughput, Cloud quota governance или dedicated support. |
| Data use | Paid Developer API terms достаточно для ревью данных. | Требуются residency, retention, audit или contract controls. |
| Project ownership | Google Cloud project, collaborators, billing account и key restrictions достаточны. | Нужны IAM, org policy, service accounts, network controls и centralized security review. |
| Model access | Нужная модель доступна в Developer API. | Нужны Model Garden, partner models, managed model platform или MLOps integration. |
Страница pricing у Google разделяет Free, Paid и Enterprise. Надежный вывод не в том, чтобы копировать текущие цены в вечную таблицу. Важнее понимать смысл слоя: Free полезен для разработки и небольших проектов, но имеет data-use boundary для улучшения продуктов; Paid предназначен для production applications с большим объемом или продвинутыми возможностями и заявляет, что content не используется для улучшения продуктов; Enterprise указывает на enterprise controls, support, security/compliance, provisioned throughput, discounts, MLOps и Model Garden.
Документация billing добавляет практическую деталь: rate limits, tiers, billing state и caps принадлежат проекту или billing account. Проект может перейти в paid setup, не превращая каждое архитектурное решение в миграцию на Cloud enterprise route.
Поэтому фраза "production значит Vertex" плоха как правило. Сначала назовите blocker. Если blocker - usage volume, billing, paid model row, project ownership или paid data-use boundary, платный Developer API должен быть первым кандидатом. Если blocker - policy, residency, IAM, provisioned capacity или compliance evidence, тогда enterprise platform становится реальным решением.
Когда переходить на enterprise platform
Enterprise migration - это решение о контролях. Хорошие причины звучат конкретно.
| Trigger | Вопрос перед миграцией |
|---|---|
| IAM и org policy | Нужны ли Cloud IAM, service accounts, org policy или centralized security review? |
| Endpoint и region control | Требуются ли regional endpoint, global endpoint behavior или location-specific architecture? |
| Data residency и retention | Есть ли письменное требование residency, retention, logging или audit, которое Developer API не закрывает? |
| Provisioned throughput | Нужна ли зарезервированная capacity вместо обычного tier movement и retries? |
| Model Garden и MLOps | Нужны ли broader managed model platform, evaluation pipelines, deployment governance или partner models? |
| Network и security controls | Требуются ли VPC, private connectivity, centralized logs или Cloud security controls? |
| Support и compliance | Нужны ли enterprise support, contract review, compliance workflow или procurement alignment? |
Важно не переоценить слово endpoint. Документация Google Cloud locations описывает regional и global endpoints, но endpoint сам по себе не гарантирует data residency или in-region ML processing. Для residency надо сверяться с data residency docs. Для zero data retention надо сверяться с zero data retention docs и конкретными действиями, которые должен выполнить заказчик.
Миграционный brief должен назвать: какой контроль нужен, какой документ Google им владеет, какой сервис или endpoint его закрывает, какую проверку примет security или compliance reviewer. "Более enterprise" не является доказательством.
API keys и project ownership изменили старое сравнение
Старые объяснения часто говорят: AI Studio - это простой личный ключ, а Cloud route - серьезная identity platform. Текущая картина более тонкая.
Документация Gemini API key говорит, что запросы Gemini API могут использовать standard API keys или authorization API keys. Новые ключи в Google AI Studio создаются как auth keys by default. Там же сказано, что unrestricted standard keys отклоняются после 19 июня 2026 года, а standard keys нужно мигрировать до сентября 2026 года.
Это не делает AI Studio enterprise platform. Это означает, что Developer API route стал более project-aware, чем старые описания "simple key" предполагали. Каждый ключ связан с Google Cloud project; проект управляет collaborators, permissions и billing context. Для многих команд этого достаточно. Но это не заменяет organization-wide IAM, Cloud network controls, residency architecture, retention policy или MLOps governance.
| Вопрос | Developer API answer | Enterprise platform answer |
|---|---|---|
| Может ли project-owned key обслуживать backend app? | Да, если project, billing, limits, model и key restrictions подходят. | Да, но причина перехода должна быть шире ключа. |
| Можно ли держать ключ во фронтенде? | Нет. Ключ должен жить server-side или в managed secret. | Тоже нет. Enterprise controls не делают public credentials безопасными. |
| Доказывает ли один key production readiness? | Нет. Нужны billing, live limits, data policy, region и model access. | Нет. Нужны IAM, endpoints, residency, retention, support и rollout controls. |
| Важны ли даты июня и сентября 2026? | Да, если старые standard keys еще используются. | Да, но enterprise migration не должна быть обходом плохой key hygiene. |
Практический checklist миграции
Перед переходом из Developer API в enterprise route запишите короткое decision record.
- Назовите текущий маршрут: AI Studio prototype, free Developer API project, paid Developer API project или existing Cloud enterprise route.
- Назовите unresolved blocker: quota, billing, data-use policy, region, IAM, support, provisioned capacity, MLOps, Model Garden, compliance или procurement.
- Откройте owner doc: API keys, pricing, billing, rate limits, enterprise locations, data residency или zero retention.
- Решите, закрывает ли blocker paid Developer API или нужен enterprise platform control.
- Сделайте небольшой pilot на целевом route с той же model family, request shape, latency expectations, retry policy и logging boundary.
- Подтвердите cost owner, quota owner, data owner и support owner до переноса трафика.
- Держите rollback простым: старый Developer API route должен оставаться callable, пока enterprise path не докажет равное или лучшее поведение.
Такой record полезнее широкой feature matrix. Команда, которой нужны только quota и billing, не должна раньше времени принимать complexity enterprise migration. Команда с data residency или provisioned throughput не должна продолжать жить на быстрых ключах без доказуемого контроля.
Где решать setup и quota
| Узкая задача | Лучший следующий маршрут |
|---|---|
| Создать ключ, сохранить его безопасно, сделать первый запрос, разобрать 403/429 readiness. | Google AI Studio API key setup |
| Проверить free tier, project-level limits, 429, billing state или paid tier. | Gemini API free tier limits |
| Понять, нужны ли Cloud controls вместо обычной Developer API production readiness. | Оставайтесь на platform-choice маршруте и используйте migration checklist. |
Разделение сохраняет полезность. Setup route должен давать команды и восстановление после ошибок. Quota route должен проверять живые лимиты и цену. Platform route должен держать names, owners и migration threshold.
Часто задаваемые вопросы
Должно ли production-приложение Gemini использовать Vertex AI?
Не обязательно. Большинство приложений может начинать с Gemini Developer API, а платный Developer API может закрыть billing, quota, project ownership, paid model access и backend integration. Enterprise route нужен, когда есть named controls: IAM, data controls, provisioned throughput, MLOps, Model Garden, support, compliance или procurement.
Google AI Studio только для прототипов?
Нет. AI Studio - browser surface для экспериментов и управления ключами, а Gemini Developer API может оставаться маршрутом реального приложения. Вопрос не в том, "настоящий" ли сервис, а в том, какой нерешенный риск остался.
Gemini и Vertex AI - это одно и то же?
Нет. Gemini models доступны через разные Google surfaces. Direct developer route - Gemini Developer API. Enterprise Google Cloud route сейчас описывается через Gemini Enterprise Agent Platform и related Cloud AI services; Vertex AI часто остается shorthand для этой стороны.
Когда платить за Developer API вместо миграции?
Когда blocker - usage volume, billing, project ownership, paid model rows или paid data-use boundary. Это часто признак того, что прототип должен стать paid Developer API project, а не enterprise migration.
Когда enterprise platform действительно стоит перехода?
Когда требование называет platform control: IAM, org policy, regional endpoint architecture, data residency, zero retention work, provisioned throughput, Model Garden, MLOps, private networking, enterprise support, compliance review или procurement structure.
Что делать со старыми API keys после июня 2026?
Старые standard keys нужно проверить. Документация Google говорит, что unrestricted standard keys отклоняются после 19 июня 2026 года, а standard keys нужно мигрировать до сентября 2026 года. Новые AI Studio keys создаются как auth keys by default.
Regional endpoint гарантирует data residency?
Нет. Endpoint location и data residency - разные вещи. Если residency важна, проверяйте current data residency docs, supported location, request path, logging behavior и retention setup.
Можно ли держать Developer API и enterprise route одновременно?
Да. Staged migration часто лучше резкого switch. Developer API может обслуживать prototypes, low-risk workloads или rollback, пока enterprise pilot доказывает IAM, endpoint, data, throughput, logging, support и cost behavior.
