На этой странице вы найдете ответы на часто задаваемые вопросы и информацию об устранении неполадок, связанных с Firebase AI Logic и его использованием с Gemini API.
- Панели мониторинга
- Общие вопросы
- Часто задаваемые вопросы об изменениях (например, о прекращении поддержки и отключении моделей)
- Часто задаваемые вопросы о безопасности
Дополнительные ресурсы:
Устраните неполадки, связанные с кодами ошибок.
Подробнее о платежной конфигурации, ценах и платежах…
Подробнее об ограничениях и квотах…
Панели мониторинга
Agent Platform Gemini API (formerly Vertex AI) (
Vertex Gemini API)
Общие вопросы
Различия между Gemini Developer API и Agent Platform Gemini API (formerly Vertex AI)
В таблице ниже перечислены важные различия между двумя поставщиками Gemini API в целом, независимо от того, как вы получаете к ним доступ.
| Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI) | |
|---|---|---|
| Цены | Доступно как в бесплатном тарифном плане Spark, так и в тарифном плане Blaze с оплатой по мере использования1. | Всегда требуется тарифный план Blaze с оплатой по мере использования1 (при использовании с Firebase AI Logic). |
| Ограничения частоты запросов (квота) | Явные ограничения частоты запросов | Использует динамическую общую квоту (DSQ), которая распределяется между всеми, кто использует эту модель в этом регионе. Доступна выделенная производительность. |
| Указание местоположения для доступа к модели | не поддерживается API | поддерживается API |
| Поддержка URL Cloud Storage | не поддерживается API 2 |
Общедоступные файлы и файлы, защищенные Firebase Security Rules |
| Поддержка URL YouTube и URL браузера | Только URL YouTube | URL YouTube и URL браузера |
1 У двух поставщиков API разные тарифы на оплату по мере использования. Подробную информацию можно найти в документации. Также обратите внимание, что бонус в размере 300 долларов США, полученный в рамках бесплатного пробного периода, нельзя использовать для оплаты Gemini Developer API, а с 16 ноября 2026 года изменились условия использования этого бонуса для оплаты Agent Platform Gemini API (formerly Vertex AI).
2 Files API для Gemini Developer API не поддерживается в SDK Firebase AI Logic.
В таблице ниже указано, какие функции доступны у двух поставщиков Gemini API. Эта таблица относится только к использованию Firebase AI Logic client SDK.
| Функция | Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI) |
|---|---|---|
| Поддержка моделей Gemini | поддерживается | поддерживается |
| Поддержка Gemini Live API | поддерживается | поддерживается |
| Интеграция с Firebase App Check | поддерживается | поддерживается |
| Совместимость с Firebase Remote Config | поддерживается | поддерживается |
| Поддержка ИИ-мониторинга в консоли Firebase | поддерживается | поддерживается |
Как использовать Gemini Developer API и Agent Platform Gemini API (formerly Vertex AI)
В проекте Firebase можно включить оба поставщика Gemini API, а в приложении – оба API.
Чтобы переключаться между поставщиками API в коде, убедитесь, что вы правильно настроили бэкенд-службу в коде.
Необходимые API и как их включить
|
Выберите поставщика Gemini API, чтобы посмотреть контент, относящийся к нему |
Чтобы использовать SDK Firebase AI Logic с Gemini Developer API, в вашем проекте должны быть включены два API:
- Gemini Developer API (
generativelanguage.googleapis.com) - Firebase AI Logic API (
firebasevertexai.googleapis.com)
Включите эти два API в консоли Firebase:
В консоли Firebase выберите AI Services (Сервисы ИИ) > AI Logic (Логика ИИ).
Нажмите Начать.
Выберите, чтобы начать работу с Gemini Developer API.
Откроется пошаговое руководство, которое поможет вам включить оба API. Firebase также создаст управляемый Google сервисный аккаунт (P4SA) для авторизации использования Gemini API и добавит API Firebase AI Logic в белый список для вашего ключа API Firebase.
Как отключить API в проекте Firebase
Firebase AI LogicМы стараемся максимально упростить настройку проекта Firebase для использования выбранного вами поставщика Gemini API. В частности, в ходе некоторых процессов, например при работе с пошаговыми инструкциями в консоли Firebase, в проекте Firebase будут включены необходимые API.
Однако если вы решите не использовать Firebase AI Logic или одного из поставщиков Gemini API, вы можете отключить связанные API в своем проекте Firebase.
Отключите API, связанные с использованием Gemini Developer API
Чтобы использовать SDK Firebase AI Logic с Gemini Developer API, в вашем проекте должны быть включены два API:
- Gemini Developer API (
generativelanguage.googleapis.com) - Firebase AI Logic API (
firebasevertexai.googleapis.com)
Если вы хотите полностью прекратить использовать Firebase AI Logic:
Нажмите на каждую из ссылок выше, чтобы перейти на страницу соответствующего API в консоли Google Cloud, а затем нажмите Manage (Управление).
Откройте вкладку Metrics (Показатели) и убедитесь, что API не используется.
Если вы все равно хотите отключить API, нажмите Отключить API вверху страницы.
Удалите Firebase AI Logic API из списка выбранных API, которые можно вызывать с помощью ключей Firebase API. Чтобы узнать, как изменить этот список, ознакомьтесь с часто задаваемыми вопросами о белом списке для ключей Firebase API.
Если вы хотите продолжить использовать Firebase AI Logic, но с Agent Platform Gemini API (formerly Vertex AI):
Перейдите на страницу Gemini Developer API в консоли Google Cloud и нажмите Manage (Управление).
Откройте вкладку Metrics (Показатели) и убедитесь, что API не используется.
Если вы все равно хотите отключить API, нажмите Отключить API вверху страницы.
Убедитесь, что в вашем проекте включены необходимые API для Agent Platform Gemini API (formerly Vertex AI).
Отключите API, связанные с использованием Agent Platform Gemini API (formerly Vertex AI)
Чтобы использовать SDK Firebase AI Logic с Agent Platform Gemini API (formerly Vertex AI), в вашем проекте должны быть включены два API:
- Agent Platform API (
aiplatform.googleapis.com) - Firebase AI Logic API (
firebasevertexai.googleapis.com)
Если вы хотите полностью прекратить использовать Firebase AI Logic:
Нажмите на каждую из ссылок выше, чтобы перейти на страницу соответствующего API в консоли Google Cloud, а затем нажмите Manage (Управление).
Откройте вкладку Metrics (Показатели) и убедитесь, что API не используется.
Если вы все равно хотите отключить API, нажмите Отключить API вверху страницы.
Удалите Firebase AI Logic API из списка выбранных API, которые можно вызывать с помощью ключей Firebase API. Чтобы узнать, как изменить этот список, ознакомьтесь с часто задаваемыми вопросами о белом списке для ключей Firebase API.
Если вы хотите продолжить использовать Firebase AI Logic, но с Gemini Developer API:
В консоли Google Cloud перейдите на страницу Agent Platform API и нажмите Manage (Управление).
Откройте вкладку Metrics (Показатели) и убедитесь, что API не используется.
Если вы все равно хотите отключить API, нажмите Отключить API вверху страницы.
Убедитесь, что в вашем проекте включены необходимые API для Gemini Developer API.
Разрешения, необходимые для использования Firebase AI Logic
| Действие | Необходимые разрешения IAM | Роли IAM, которые по умолчанию включают необходимые разрешения |
|---|---|---|
| Перейдите на тарифный план Blaze с оплатой по мере использования | firebase.billingPlans.updateresourcemanager.projects.createBillingAssignmentresourcemanager.projects.deleteBillingAssignment
|
Владелец |
| Включите API в проекте | serviceusage.services.enable |
Редактор Владелец |
| Создать приложение Firebase | firebase.clients.create |
Администратор Firebase Редактор Владелец |
Поддерживаемые модели при использовании Firebase AI Logic
Ознакомьтесь со списком поддерживаемых моделей. Мы часто добавляем в SDK новые возможности, поэтому следите за обновлениями в этом разделе часто задаваемых вопросов, а также в примечаниях к выпускам, блогах и сообщениях в социальных сетях.
Firebase AI Logic поддерживает следующие модели:
Gemini Developer API
- Большинство базовых моделей Gemini
Agent Platform Gemini API (formerly Vertex AI)
- Большинство базовых моделей Gemini
Firebase AI Logic не поддерживает следующие модели (независимо от выбранного поставщика Gemini API):
Оптимизированные модели
модели встраивания; модели Veo; модели Lyria; модели робототехники; модели использования компьютера; модели Gemini Omni; модели Gemini Cyber.
Как задать ограничение на количество сообщений для одного пользователя
По умолчанию Firebase AI Logic устанавливает ограничение на количество запросов на пользователя на уровне 100 запросов в минуту.
Чтобы изменить ограничение частоты запросов на пользователя, необходимо изменить настройки квоты для Firebase AI Logic API.
Подробнее о квоте API Firebase AI Logic… На этой странице вы также узнаете, как посмотреть и изменить квоту.
Как сократить задержку и использование токенов
Если вы сталкиваетесь с высокой задержкой или большим расходом токенов, скорее всего, это связано с уровнем рассуждения, заданным для используемой модели.
Gemini 3 и более поздние модели всегда используют внутренний "процесс мышления", который значительно улучшает их способность рассуждать и планировать многоэтапные действия. Это делает их высокоэффективными для сложных задач, таких как программирование, высшая математика и анализ данных.
Однако для некоторых задач высокий уровень мышления не требуется, и вы можете настроить модель на более низкий уровень. Чем ниже уровень, тем меньше задержка и количество используемых токенов. Чтобы понять, насколько модели может понадобиться способность рассуждать, ознакомьтесь со сравнением сложности задач.
Обратите внимание, что для большинства моделей Gemini 3 и более поздних версий уровень мышления по умолчанию – HIGH.
Требования к MIME-типам для мультимодальных запросов (например, для изображений, PDF-файлов, видео и аудио).
В каждом мультимодальном запросе всегда необходимо указывать следующее:
Файл
mimeType. См. исключение ниже.Файл. Вы можете предоставить файл в виде встроенных данных или указать его URL.
Узнайте, какие типы входных файлов поддерживаются, как указать MIME-тип и какие есть варианты предоставления файла, в разделе Поддерживаемые входные файлы и требования.
Исключение для включения MIME-типа в запрос
Исключением из правила предоставления MIME-типа являются встроенные изображения, которые передаются в запросах от нативных приложений для Android и Apple.
SDK Firebase AI Logic для платформ Android и Apple предоставляют упрощенный и удобный способ обработки изображений в запросах: все изображения (независимо от их формата) преобразуются на клиентской стороне в формат JPEG с качеством 80 % перед отправкой на сервер. Это означает, что когда вы предоставляете изображения в виде встроенных данных с помощью SDK для платформ Android и Apple, вам не нужно указывать MIME-тип в запросе.
Этот упрощенный способ обработки показан в документации по Firebase AI Logic в примерах отправки изображений в кодировке base64 в запросах.
Ниже приведена дополнительная информация об этой функции для разных платформ.
На устройстве Android
Вы можете использовать упрощенный способ обработки нативных типов изображений (
Bitmap) в мультимодальных запросах, содержащих изображения в виде встроенных данных (см. пример).Чтобы лучше контролировать графические форматы и конверсии, вы можете предоставить изображения в виде
InlineDataPartи указать определенный MIME-тип. Пример:content { inlineData(/* PNG as byte array */, "image/png") }
Для платформ Apple
Вы можете воспользоваться упрощенным способом обработки типов изображений, встроенных в платформу (
UIImage,NSImage,CIImageиCGImage), в мультимодальных запросах, содержащих изображения в виде встроенных данных (см. пример).Чтобы лучше контролировать графические форматы и конверсии, вы можете предоставить изображения в виде
InlineDataPartи указать определенный MIME-тип. Пример:InlineDataPart(data: Data(/* PNG Data */), mimeType: "image/png")
Продвинутые функции, которые пока недоступны при использовании Firebase AI Logic: обоснование с помощью Google Картинки, точная настройка модели, генерация встраиваний и семантический поиск.
Перечисленные ниже функции поддерживаются различными моделями и поставщиками API, но недоступны при использовании Firebase AI Logic:
- Обоснование с Google Картинками
- Точная настройка модели
- Генерация встраиваний
- Семантический поиск
Если вы хотите отправить запрос на добавление функции или проголосовать за существующий запрос, посетите Firebase UserVoice.
Использование данных для обучения моделей
Подробнее об управлении данными и ответственном подходе к ИИ…
Часто задаваемые вопросы об изменениях
В этом разделе приведены часто задаваемые вопросы о прекращении поддержки или отключении моделей, а также об изменениях в оплате, API, SDK или нашем брендинге.
Изменения в использовании бонусов бесплатной пробной версии на сумму 300 долларов США для Agent Platform Gemini API (formerly Vertex AI) (с 16 ноября 2026 г.)
С 16 ноября 2026 года изменились условия использования Google Cloudбонуса в размере 300 долларов США в рамках бесплатной пробной версии Agent Platform Gemini API (formerly Vertex AI).
Если вы создадите новый аккаунт с бесплатной пробной версией 16 ноября 2026 года или позже, то не сможете использовать бонусы для оплаты Agent Platform Gemini API.
Если вы создали аккаунт с бесплатной пробной версией до 16 ноября 2026 года, вы по-прежнему можете использовать бонусы для Agent Platform Gemini API, пока у вас есть аккаунт с бесплатной пробной версией.
Если вы создали аккаунт с бесплатной пробной версией до 16 ноября 2026 года и перешли на платный аккаунт до 16 ноября 2026 года, вы по-прежнему можете использовать бонусы для Agent Platform Gemini API.
Если вы создали аккаунт с бесплатной пробной версией до 16 ноября 2026 г. и перешли на платный аккаунт 16 ноября 2026 г. или позже, вы больше не сможете использовать бонусы для оплаты Agent Platform Gemini API.
Подробную информацию вы найдете в статьях Цены и Часто задаваемые вопросы о бесплатной пробной версии Firebase.
Устаревшие или отключенные модели: список и замена
Когда Google выпускает стабильную версию модели, мы стремимся поддерживать ее доступность как минимум в течение 12 месяцев, прежде чем прекратить ее поддержку.
Однако обратите внимание на следующее:
Некоторые стабильные модели Agent Platform Gemini API (formerly Vertex AI) доступны только в течение короткого срока. Это значит, что они могут быть отключены (выведены из эксплуатации) уже через 45 дней после выпуска модели, которая придет им на замену.
В случае с Gemini Developer API вместо отключения модели сервис иногда автоматически перенаправляет запрос к более новой модели. Запросы к более новой модели оплачиваются по ее тарифам.
За несколько недель до даты прекращения поддержки в проектах, где модель не использовалась, будет заблокирована возможность начать ее использовать.
Когда выпускается стабильная версия модели, все ее экспериментальные и предварительные версии обычно отключаются в течение нескольких дней или недель. В этом разделе часто задаваемых вопросов перечислены не все предыдущие предварительные и экспериментальные модели.
Модели общего назначения
| Модель | Gemini Developer API | Agent Platform Gemini API |
|---|---|---|
gemini-3.7-flash 1
Дата выпуска: 13 августа 2026 г. Стадия выпуска: стабильная версия |
Запросы перенаправляются на gemini-3.8-flash
Замена: gemini-3.8-flash
|
Дата прекращения поддержки: 28 января 2027 г.
Замена: gemini-3.8-flash
|
gemini-3.6-flash 1
Дата выпуска: 21 июля 2026 г. Стадия выпуска: стабильная версия |
Дата прекращения поддержки: ---
Замена: gemini-3.8-flash
|
Дата прекращения поддержки: 19 ноября 2026 г.
Замена: gemini-3.8-flash
|
gemini-3.5-flash
Дата выпуска: 19 мая 2026 г. Стадия выпуска: стабильная версия |
Запросы перенаправляются на gemini-3.6-flash
Замена: gemini-3.8-flash
|
Дата прекращения поддержки: ---
Замена: gemini-3.8-flash
|
gemini-3.1-pro-preview
Дата выпуска: 19 февраля 2026 г. Стадия выпуска: предварительная версия |
Дата прекращения поддержки: ---
Замена: gemini-4-hydrogen
|
Дата прекращения поддержки: ---
Замена: gemini-4-hydrogen
|
| Модель | Gemini Developer API | Agent Platform Gemini API |
|---|---|---|
gemini-2.5-pro
Дата выпуска: 17 июня 2025 г. Стадия выпуска: стабильная версия |
Запросы, перенаправленные в gemini-3.8-flash (с 1 декабря 2026 г.)
Замена: gemini-3.8-flash
|
Дата прекращения поддержки: 20 октября 2026 г.
Замена: gemini-3.8-flash
|
gemini-2.5-flash
Дата выпуска: 17 июня 2025 г. Стадия выпуска: стабильная версия |
Запросы, перенаправленные в gemini-3.5-flash-lite (с 1 декабря 2026 г.)
Замена: gemini-3.5-flash-lite
|
Дата прекращения поддержки: 20 октября 2026 г.
Замена: gemini-3.5-flash-lite
|
gemini-2.5-flash-lite
Дата выпуска: 22 июля 2025 г. Стадия выпуска: стабильная версия |
Дата прекращения поддержки: ---
Замена: gemini-3.5-flash-lite
|
Дата прекращения поддержки: 20 октября 2026 г.
Замена: gemini-3.5-flash-lite
|
| Модель | Gemini Developer API | Agent Platform Gemini API |
|---|---|---|
gemini-2.0-flash-001
Дата выпуска: 5 февраля 2025 г. Стадия выпуска: прекращение поддержки |
Дата прекращения поддержки: 1 июня 2026 г.
Замена: gemini-3.5-flash-lite
|
Дата прекращения поддержки: 1 июня 2026 г.
Замена: gemini-3.5-flash-lite
|
gemini-2.0-flash
Дата выпуска: 10 февраля 2025 г. Стадия выпуска: прекращение поддержки |
Дата прекращения поддержки: 1 июня 2026 г.
Замена: gemini-3.5-flash-lite
|
Дата прекращения поддержки: 1 июня 2026 г.
Замена: gemini-3.5-flash-lite
|
gemini-2.0-flash-lite-001
Дата выпуска: 25 февраля 2025 г. Этап выпуска: прекращение поддержки |
Дата прекращения поддержки: 1 июня 2026 г.
Замена: gemini-3.5-flash-lite
|
Дата прекращения поддержки: 1 июня 2026 г.
Замена: gemini-3.5-flash-lite
|
gemini-2.0-flash-lite
Дата выпуска: 25 февраля 2025 г. Этап выпуска: прекращение поддержки |
Дата прекращения поддержки: 1 июня 2026 г.
Замена: gemini-3.5-flash-lite
|
Дата прекращения поддержки: 1 июня 2026 г.
Замена: gemini-3.5-flash-lite
|
1 Для Agent Platform Gemini API (formerly Vertex AI) это модель краткосрочной доступности. Подробнее о версиях моделей и шаблонах названий…
Также прекращена поддержка следующих моделей общего назначения:
gemini-1.0-pro,
gemini-1.0-pro-001,
gemini-1.0-pro-002,
gemini-1.0-pro-vision,
gemini-1.0-pro-vision-001
gemini-1.5-flash-001,
gemini-1.5-flash,
gemini-1.5-flash-002,
gemini-1.5-pro-001,
gemini-1.5-pro,
gemini-1.5-pro-002
Модели для генерации изображений (Nano Banana и Imagen)
| Модель | Gemini Developer API | Agent Platform Gemini API |
|---|---|---|
gemini-2.5-flash-image
Дата выпуска: 2 октября 2025 г. Стадия выпуска: прекращение поддержки |
Дата прекращения поддержки: 2 октября 2026 г.
Замена: gemini-nano-banana-2.1
|
Дата прекращения поддержки: 2 октября 2026 г.
Замена: gemini-nano-banana-2.1
|
| Модель | Gemini Developer API | Agent Platform Gemini API |
|---|---|---|
imagen-4.0-generate-001
Дата выпуска: 14 августа 2025 г. Этап выпуска: прекращение поддержки |
Дата прекращения поддержки: 30 июня 2026 г.
Замена: gemini-nano-banana-2.1
|
Дата прекращения поддержки: 30 июня 2026 г.
Замена: gemini-nano-banana-2.1
|
imagen-4.0-fast-generate-001
Дата выпуска: 14 августа 2025 г. Этап выпуска: прекращение поддержки |
Дата прекращения поддержки: 30 июня 2026 г.
Замена: gemini-nano-banana-2.1
|
Дата прекращения поддержки: 30 июня 2026 г.
Замена: gemini-nano-banana-2.1
|
imagen-4.0-ultra-generate-001
Дата выпуска: 14 августа 2025 г. Этап выпуска: прекращение поддержки |
Дата прекращения поддержки: 30 июня 2026 г.
Замена: gemini-3-pro-image
|
Дата прекращения поддержки: 30 июня 2026 г.
Замена: gemini-3-pro-image
|
imagen-3.0-capability-001
Дата выпуска: 10 декабря 2024 г. Этап выпуска: прекращение поддержки |
Что не поддерживается |
Дата прекращения поддержки: 30 июня 2026 г.
Замена: gemini-nano-banana-2.1
|
imagen-3.0-generate-002
Дата выпуска: 23 января 2025 г. Этап выпуска: прекращение поддержки |
Дата прекращения поддержки: 30 июня 2026 г.
Замена: gemini-nano-banana-2.1
|
Дата прекращения поддержки: 30 июня 2026 г.
Замена: gemini-nano-banana-2.1
|
imagen-3.0-generate-001
Дата выпуска: 31 июля 2024 г. Этап выпуска: прекращение поддержки |
Что не поддерживается |
Дата прекращения поддержки: 30 июня 2026 г.
Замена: gemini-nano-banana-2.1
|
imagen-3.0-fast-generate-001
Дата выпуска: 31 июля 2024 г. Этап выпуска: прекращение поддержки |
Что не поддерживается |
Дата прекращения поддержки: 30 июня 2026 г.
Замена: gemini-nano-banana-2.1
|
Аудио – модели синтеза речи (TTS)
| Модель | Gemini Developer API | Agent Platform Gemini API |
|---|---|---|
gemini-3.1-flash-tts-preview
Дата выпуска: 17 июня 2026 г. Стадия выпуска: предварительная версия |
Дата прекращения поддержки: 17 ноября 2026 г.
Замена: gemini-3.8-flash-tts или
gemini-3.8-flash-lite-tts
|
Дата прекращения поддержки: 17 ноября 2026 г.
Замена: gemini-3.8-flash-tts или
gemini-3.8-flash-lite-tts
|
Аудио – Live API модель
| Модель | Gemini Developer API | Agent Platform Gemini API |
|---|---|---|
gemini-live-2.5-flash-preview
Дата выпуска: 17 июня 2025 г. Этап выпуска: прекращение поддержки |
Дата прекращения поддержки: 9 декабря 2025 г.
Замена: gemini-3.1-flash-live-preview
|
Дата прекращения поддержки: 9 декабря 2025 г.
Замена: gemini-live-2.5-flash-native-audio
|
gemini-2.0-flash-live-001
Дата выпуска: 9 апреля 2025 г. Этап выпуска: прекращение поддержки |
Дата прекращения поддержки: 9 декабря 2025 г.
Замена: gemini-3.1-flash-live-preview
|
Дата прекращения поддержки: 9 декабря 2025 г.
Замена: gemini-live-2.5-flash-native-audio
|
gemini-2.0-flash-live-preview-04-09
Дата выпуска: 9 апреля 2025 г. Этап выпуска: прекращение поддержки |
Что не поддерживается |
Дата прекращения поддержки: 9 декабря 2025 г.
Замена: gemini-live-2.5-flash-native-audio
|
Изменения, необходимые при прекращении поддержки или отключении моделей
Где найти дату прекращения поддержки модели?
Вот как можно узнать дату прекращения поддержки модели:
Google отправляет электронные письма соответствующим участникам проекта.
Мы публикуем объявления и напоминания о предстоящих отключениях в различных каналах:
- Примечания к выпуску (см. пример).
- Баннеры на уровне страницы в документации, на странице поддерживаемых моделей и в разделе часто задаваемых вопросов об устаревших и отключенных моделях.
Что делать, если используемая вами модель скоро будет отключена?
Вам нужно внести эти изменения до даты прекращения поддержки, иначе любые запросы к отключенной модели будут возвращать ошибку 404.
Найдите подходящую поддерживаемую модель и ее название.
Мы также рекомендуем модели для замены в разделе часто задаваемых вопросов об устаревших и отключенных моделях.
Обновите название модели, используемой в приложении.
Название модели задается во время инициализации при создании экземпляра
GenerativeModel,LiveModelилиImagenModel. Обязательно ознакомьтесь с важной рекомендацией ниже об использовании шаблонов запросов Firebase Remote Config или сервера.Проверьте, нужно ли вам обновить код.
Обычно вам не нужно изменять код, который вызывает модель. Вот некоторые исключения:
Неподдерживаемые параметры выборки. В последних моделях Gemini 4.x и Gemini 3.x не поддерживается несколько параметров, в частности температура, top-K, top-P, штраф за частоту, штраф за присутствие и количество кандидатов.
Уровень мышления и бюджет мышления. Начиная с моделей Gemini 3.x, следует использовать
thinkingLevelвместоthinkingBudget(ноthinkingBudgetпо-прежнему поддерживается для обратной совместимости). Однако начиная с моделей Gemini 4.x,thinkingBudgetне поддерживается. Подробнее о мышлении…Экспериментируйте с уровнем рассуждения. Если вы переходите на новое поколение (например, с 2.5 на 3.8) и хотите сохранить прежнюю производительность и поведение (например, задержку), попробуйте установить более низкий уровень рассуждения. Подробнее о мышлении…
Протестируйте приложение, чтобы убедиться, что ответы по-прежнему соответствуют ожиданиям.
Изменения, необходимые для ребрендинга Vertex AI в Agent Platform
В середине 2026 года Google Cloud переименовала Vertex AI в Gemini Enterprise Agent Platform (или Agent Platform). В экосистеме Firebase этот сервис называется Agent Platform Gemini API.
Для Google Cloud ребрендинг включал следующее: Обратите внимание, что были и другие изменения, но они не относятся к Firebase AI Logic.
Ребрендинг продукта Vertex AI в Gemini Enterprise Agent Platform (или Agent Platform), который включает новые URL для консоли Google Cloud и документации.
Изменение отображаемого названия API с Vertex AI API на Agent Platform API. Обратите внимание, что название сервиса осталось прежним:
aiplatform.googleapis.com.Vertex AI Studio переименован в Agent Studio.
Возможности базовых API и поддерживаемых моделей не изменятся.
В SDK Firebase AI Logic мы учли этот ребрендинг, обновив синтаксис инициализации для бэкенд-сервиса Gemini API и местоположение по умолчанию для доступа к модели при использовании нового синтаксиса.
Новый синтаксис инициализации для бэкенд-службы Gemini API:
Swift
Изменить "
vertexAI" на "agentPlatform".- Синтаксис
agentPlatformдоступен в SDK версии 12.17.0 и более поздних. - Синтаксис
vertexAIбыл удален в версии 13.0.0 SDK.
BEFORE
// ... // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the legacy `vertexAI` syntax, the default location is `us-central1`, so // specifying a location is usually required since most models are *not* supported in `us-central1`. let ai = FirebaseAI.firebaseAI(backend: .vertexAI(location: "LOCATION")) // ...AFTER
// ... // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the `agentPlatform` syntax, the default location is `global`, so // specifying a location is usually optional since most models are supported in `global`. let ai = FirebaseAI.firebaseAI(backend: .agentPlatform(location: "LOCATION")) // ...Kotlin
Изменить "
vertexAI" на "agentPlatform".- Синтаксис
agentPlatformдоступен в SDK версии 17.15.0 и выше, а также в Firebase Android BoM версии 34.17.0 и выше. - Синтаксис
vertexAIбыл удален в версии 18.0.0 SDK и версии 35.0.0 BoM.
BEFORE
// ... // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the legacy `vertexAI` syntax, the default location is `us-central1`, so // specifying a location is usually required since most models are *not* supported in `us-central1`. val ai = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION")) // ...AFTER
// ... // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the `agentPlatform` syntax, the default location is `global`, so // specifying a location is usually optional since most models are supported in `global`. val ai = Firebase.ai(backend = GenerativeBackend.agentPlatform(location = "LOCATION")) // ...Java
Изменить "
vertexAI" на "agentPlatform".- Синтаксис
agentPlatformдоступен в SDK версии 17.15.0 и выше, а также в Firebase Android BoM версии 34.17.0 и выше. - Синтаксис
vertexAIбыл удален в версии 18.0.0 SDK и версии 35.0.0 BoM.
BEFORE
// ... // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the legacy `vertexAI` syntax, the default location is `us-central1`, so // specifying a location is usually required since most models are *not* supported in `us-central1`. GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION")); // ...AFTER
// ... // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the `agentPlatform` syntax, the default location is `global`, so // specifying a location is usually optional since most models are supported in `global`. GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.agentPlatform("LOCATION")); // ...Web
Изменить "
VertexAIBackend" на "AgentPlatformBackend".- Синтаксис
AgentPlatformBackendдоступен начиная с версии 12.17.0 Firebase JS SDK. - Синтаксис
VertexAIBackendбыл удален в версии 13.0.0 SDK.
BEFORE
import { getAI, getGenerativeModel, VertexAIBackend } from "firebase/ai"; // ... // Initialize FirebaseApp // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the legacy `VertexAIBackend` syntax, the default location is `us-central1`, so // specifying a location is usually required since most models are *not* supported in `us-central1`. const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') }); // ...AFTER
import { getAI, getGenerativeModel, AgentPlatformBackend } from "firebase/ai"; // ... // Initialize FirebaseApp // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the `AgentPlatformBackend` syntax, the default location is `global`, so // specifying a location is usually optional since most models are supported in `global`. const ai = getAI(firebaseApp, { backend: new AgentPlatformBackend('LOCATION') }); // ...Dart
Изменить "
vertexAI" на "agentPlatform".- Синтаксис
agentPlatformдоступен в плагине версии 3.15.0 и выше, а также в Firebase Flutter BoM версии 4.18.0 и выше. - Синтаксис
vertexAIбыл удален в версии 5.0.0 плагина и версии 5.0.0+ Firebase Flutter BoM.
BEFORE
// ... // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the legacy `vertexAI` syntax, the default location is `us-central1`, so // specifying a location is usually required since most models are *not* supported in `us-central1`. final ai = await FirebaseAI.vertexAI(location: 'LOCATION'); // ...AFTER
// ... // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the `agentPlatform` syntax, the default location is `global`, so // specifying a location is usually optional since most models are supported in `global`. final ai = await FirebaseAI.agentPlatform(location: 'LOCATION'); // ...Unity
Изменить "
VertexAI" на "AgentPlatform".- Синтаксис
AgentPlatformдоступен начиная с Firebase SDK для Unity версии 13.15.0. - Синтаксис
VertexAIбыл удален в версии 14.0.0 SDK.
BEFORE
// ... // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the legacy `VertexAI` syntax, the default location is `us-central1`, so // specifying a location is usually required since most models are *not* supported in `us-central1`. var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION")); // ...AFTER
// ... // Initialize the Agent Platform Gemini API backend service (formerly Vertex AI). // For the `AgentPlatform` syntax, the default location is `global`, so // specifying a location is usually optional since most models are supported in `global`. var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform(location: "LOCATION")); // ...- Синтаксис
Новое местоположение по умолчанию для доступа к модели при использовании нового синтаксиса инициализации:
При использовании нового синтаксиса инициализации Agent Platform местоположение по умолчанию –
global.Это изменение связано с тем, что почти все модели Gemini поддерживаются в
global, а Google Cloud больше не поддерживает местоположениеus-central1для новых выпусков большинства моделей Gemini.
Для приложений на Swift – изменения, необходимые для перехода с FirebaseAI на FirebaseAILogic
Для приложений на платформах Apple, начиная с Firebase SDK версии 12.5.0, Firebase AI Logic распространяется в модуле FirebaseAILogic. В SDK версии 13.0.0 модуль FirebaseAI был удален.
Почему мы внесли это изменение?
Ранее этот сервис распространялся в составе модуля FirebaseAI. Однако нам пришлось переименовать его в FirebaseAILogic по следующим причинам:
Избегайте конфликта имен между модулем и классом, который вызывает проблемы в двоичных дистрибутивах.
Разрешите нам использовать макросы Swift для разработки будущих функций.
Что делать, если вы переходите на версию 12.5.0+ или 13.0.0+
В Firebase 12 (начиная с версии 12.5.0) изменение названия модуля на FirebaseAILogic не нарушает работу и обратно совместимо, поэтому в Firebase 12 эти изменения рекомендуются. Однако в Firebase SDK версии 13.0.0 старый модуль FirebaseAI был удален, поэтому при обновлении до Firebase 13 эти изменения обязательны.
При выборе зависимостей Swift PM выберите
FirebaseAILogic(вместоFirebaseAI).Измените операторы импорта на
FirebaseAILogic(вместоFirebaseAI).
Почему название "Vertex AI in Firebase" изменилось на "Firebase AI Logic"
В 2024 году мы запустили набор клиентских SDK Firebase, которые могут использовать Agent Platform Gemini API (formerly Vertex AI), а также прокси-шлюз Firebase для защиты этого API от злоупотреблений и интеграции с другими продуктами Firebase. Мы назвали наш продукт "Vertex AI в Firebase", и это название точно описывало доступные на тот момент варианты использования.
Однако с тех пор мы расширили возможности нашего продукта. Например, с мая 2025 года мы поддерживаем Gemini Developer API, в том числе возможность защищать Gemini Developer API от злоупотреблений с помощью интеграции с Firebase App Check.
В результате название "Vertex AI в Firebase" больше не отражает расширенную область применения нашего продукта. Новое название – Firebase AI Logic – лучше отражает набор функций, который мы предлагаем сейчас и планируем расширять в будущем.
Ознакомьтесь с руководством по переносу, чтобы убедиться, что вы используете все новейшие функции Firebase AI Logic (и, если хотите, начните использовать Gemini Developer API).
Часто задаваемые вопросы о безопасности
В разделах ниже приведены часто задаваемые вопросы о безопасности, например о App Check или ключах API Gemini.
Часто задаваемые вопросы о Firebase App Check
Обязательное применение App Check для всех версий приложения
App Check необходимо применить ко всем версиям приложения, в которых используется Firebase AI Logic.
Крайне важно применить App Check как можно раньше, особенно до того, как вы зафиксируете приложение в общедоступной системе управления исходным кодом, поделитесь им или сделаете его общедоступным.
Если вы сразу добавите App Check в базу кода приложения, то все его версии смогут отправлять действительные токены App Check. Запрос, который не отправляет действительный токен, считается непроверенным, поэтому он блокируется, когда применяется App Check.
Если вы уже выпустили версию приложения для конечных пользователей, в которой не реализован App Check, прочитайте раздел часто задаваемых вопросов о том, как реализовать и применить App Check для уже выпущенного приложения.
Как внедрить и принудительно применить App Check для уже опубликованного приложения
Если в версии приложения не реализован App Check, запросы к Firebase AI Logic из этой версии не будут содержать действительных токенов App Check и будут считаться непроверенными. Эти запросы блокируются, когда для Firebase AI Logic принудительно применяется App Check.
2 ноября 2026 г. Firebase автоматически принудительно применила App Check для Firebase AI Logic во всех проектах, чтобы защитить Gemini API от злоупотреблений. Если вы выпустили версии приложения, в которых не реализован App Check, то можете временно отключить принудительное применение App Check для Firebase AI Logic (см. инструкции ниже). Однако если вы отключите App Check, имейте в виду, что 21 января 2027 года Firebase автоматически включит App Check снова и отключить его будет нельзя. Когда это произойдет, запросы от конечных пользователей в версиях приложения, в которых не реализован App Check, будут заблокированы. Поэтому вам необходимо как можно скорее перевести этих конечных пользователей на версии приложения, в которых реализован App Check.
Следующие инструкции помогут вам перенести приложение, чтобы вы могли принудительно использовать App Check, избегая сбоев в работе уже выпущенного приложения, в котором нет App Check.
Временно отключить принудительное применение Firebase App Check (возможно только до 21 января 2027 г.):
В консоли Firebase перейдите в раздел Security (Безопасность) > App Check (Проверка приложений) > APIs (API).
Нажмите на строку Firebase AI Logic, чтобы посмотреть графики показателей. Под графиками нажмите Настроить.
В разделе Базовая защита выберите Не применяется (только мониторинг) и нажмите Продолжить.
В разделе Защита от повторного воспроизведения выберите Отключено или Только мониторинг, а затем нажмите Продолжить.
На последнем экране проверьте подтверждение и нажмите Продолжить.
Как можно скорее добавьте в приложение рабочего поставщика подтверждения.
- Платформы Apple: DeviceCheck, App Attest или reCAPTCHA Enterprise.
- Android: Play Integrity или reCAPTCHA Enterprise
- Веб-версия reCAPTCHA Enterprise
- Flutter поддерживает всех поставщиков, перечисленных выше, включая reCAPTCHA Enterprise.
- Unity поддерживает все перечисленные выше платформы (поддержка reCAPTCHA Enterprise будет добавлена в ближайшее время).
Отслеживайте запросы из приложения, чтобы решить, когда можно будет безопасно принудительно применить App Check.
Например, если почти все недавние запросы поступили от подтвержденных клиентов, то вам следует принудительно включить App Check.
Принудительно примените App Check для Firebase AI Logic и при необходимости принудительно примените защиту от повторного воспроизведения.
Для локальной разработки, когда App Check применяется принудительно, вы можете настроить отладочный поставщик App Check и по-прежнему принудительно применять App Check для Firebase AI Logic.
Продолжить откладывать автоматическое применение App Check для Firebase AI Logic
2 ноября 2026 г. Firebase автоматически применила App Check для Firebase AI Logic во всех проектах Firebase, чтобы защитить Gemini API от злоупотреблений. Однако до 2 ноября 2026 года некоторые разработчики явно настроили свои проекты так, чтобы отложить это принудительное применение. Если вы отложили автоматическое принудительное применение, вы можете продолжать сбрасывать дату автоматического принудительного применения до 21 января 2027 года.
Когда наступит выбранная вами дата, Firebase автоматически применит App Check и удалит окно выбора даты из консоли Firebase. Вы больше не сможете откладывать автоматическое применение. Если это произойдет и вы не захотите принудительно применять App Check для Firebase AI Logic, вы можете временно отключить принудительное применение App Check. Однако имейте в виду, что 21 января 2027 г. Firebase автоматически включит App Check, и отключить его будет нельзя. Внедрите и начните использовать App Check в уже опубликованных приложениях.
Вот как продолжить откладывать автоматическое применение App Check для Firebase AI Logic (это можно делать только до 21 января 2027 г.):
В консоли Firebase перейдите в раздел Security (Безопасность) > App Check (Проверка приложений) > APIs (API).
Найдите строку Firebase AI Logic.
В конце строки найдите окно выбора даты Принудительно применяется с со значком
editИзменить .Выберите дату, когда App Check будет автоматически включена для Firebase AI Logic.
Последняя возможная дата – 21 января 2027 г. После этой даты вы не сможете отложить автоматическое принудительное применение App Check для Firebase AI Logic.
Нажмите Сохранить.
Временно отключить принудительное применение App Check (настоятельно НЕ рекомендуется)
Если вы отключаете принудительное применение App Check, потому что только начинаете работать с Firebase AI Logic или хотите попробовать этот инструмент, то вместо этогоApp Check вам следует настроить отладочный поставщик для локальной разработки.
Вот как временно отключить принудительное применение Firebase App Check (это можно сделать только до 21 января 2027 г.):
В консоли Firebase перейдите в раздел Security (Безопасность) > App Check (Проверка приложений) > APIs (API).
Нажмите на строку Firebase AI Logic, чтобы посмотреть графики показателей. Под графиками нажмите Настроить.
В разделе Базовая защита выберите Не применяется (только мониторинг) и нажмите Продолжить.
В разделе Защита от повторного воспроизведения выберите Отключено или Только мониторинг, а затем нажмите Продолжить.
На последнем экране проверьте подтверждение и нажмите Продолжить.
Обязательно снова примените App Check, особенно перед тем, как опубликовать приложение, поделиться им или загрузить его в общедоступную систему управления кодом. Если вы не включите App Check до 21 января 2027 года, Firebase сделает это автоматически.
Часто задаваемые вопросы о ключе API Gemini
Обновления системы безопасности для Gemini Developer API и Firebase AI Logic (середина 2026 г.)
Ранее Gemini Developer API для авторизации использования Gemini Developer API (generativelanguage.googleapis.com) использовались стандартные ключи API Gemini. Если вы включили Firebase AI Logic и решили использовать Gemini Developer API, Firebase создавал для вас ключ API Gemini, который был ограничен Gemini Developer API.
Этот ключ назывался Gemini Developer API key (auto created by Firebase)
С середины 2026 года Gemini Developer API будет заменен на более безопасную альтернативу – ключи авторизации (которые по сути являются сервисными аккаунтами). Firebase AI Logic. Вместо стандартного ключа API Gemini Firebase AI Logic теперь обрабатывает авторизацию для Gemini Developer API с помощью управляемого Google сервисного аккаунта (P4SA), который мы автоматически создаем для вас:
Firebase AI Logic Service Agent
(service-PROJECT_ID@
Если вы используете Gemini Developer API через Firebase AI Logic, то для перехода на новые стандарты безопасности в середине 2026 года вам не нужно ничего делать. Это касается как существующих, так и новых проектов.
Как перенести ключ API Gemini в ключ авторизации
Если вы используете Gemini Developer API через Firebase AI Logic, то для перехода на новые функции безопасности, которые станут доступны в середине 2026 года, вам не нужно ничего делать . Это касается как существующих, так и новых проектов.
Компания Firebase AI Logic автоматически вносит все необходимые изменения в систему безопасности, чтобы разработчики могли перейти на использование ключей авторизации в Gemini Developer API.
С середины 2026 года Firebase AI Logic больше не будет предоставлять и использовать стандартные ключи API Gemini. Вместо этого Firebase AI Logic теперь обрабатывает авторизацию для Gemini Developer API с помощью сервисного аккаунта, управляемого Google (P4SA), который мы автоматически создаем для вас в вашем проекте Firebase:
Сервисный агент Firebase AI Logic
(service-PROJECT_ID@
В связи с этим изменением вы можете проверить и удалить все ключи API с названием Gemini Developer API key (auto created by Firebase)
-
Этот ключ API Gemini был создан Firebase исключительно для использования с Firebase AI Logic, поэтому его можно безопасно удалить.
Однако перед удалением ключа убедитесь, что вы не использовали его по ошибке с другими инструментами, которые могут предоставлять доступ к Gemini Developer API, например с серверными SDK для генеративного ИИ или Genkit. Вот как это сделать:
- В консоли Google Cloud перейдите на страницу Gemini Developer API и нажмите Manage (Управление).
-
На вкладке Показатели в раскрывающемся списке Учетные данные выберите ключ с названием
.Gemini Developer API key (auto created by Firebase) -
Если на графиках не показано использование с начала июля 2026 г. (когда Firebase AI Logic прекратил использовать эти ключи API), то ключ можно удалить.
Если же на графиках показано использование, значит, ключ используется с другим инструментом. В этом случае переименуйте ключ, чтобы было понятно, что он используется с этим инструментом, а не с Firebase AI Logic.
-
Не удаляйте другие ключи API, в названии которых есть сегмент
.(auto created by Firebase)
Не добавляйте ключ API Gemini в базу кода мобильного или веб-приложения.
При использовании SDK Firebase AI Logic вам не нужен ключ API Gemini для авторизации использования Gemini Developer API, и вы не должны добавлять ключ API Gemini в базу кода приложения.
Не используйте ключ API Firebase в качестве ключа API Gemini.
Никогда не используйте ключ API Firebase в качестве ключа API Gemini. Настоятельно рекомендуем не добавлять Gemini Developer API в белый список для ключа Firebase API.
Ключ API Firebase – это ключ API, указанный в файле или объекте конфигурации Firebase, который вы добавляете в базу кода приложения, чтобы подключить его к Firebase. Ключ API Firebase можно включать в код, если вы используете его только с API, связанными с Firebase, например Firebase AI Logic. Рекомендуем ознакомиться с важной информацией о ключах API Firebase.
На панели APIs & Services (API и сервисы) > Credentials (Учетные данные) в консоли Google Cloud ключи API Firebase выглядят следующим образом:

Чтобы API, связанные с Firebase, работали, вам нужно добавить ключ API Firebase в базу кода приложения. Поскольку Gemini Developer API можно авторизовать с помощью ключа API, мы настоятельно рекомендуем НЕ добавлять Gemini Developer API (в консоли Google Cloud он называется Generative Language API) в белый список API для ключа API Firebase. В противном случае Gemini Developer API может быть использован в злонамеренных целях.
Как защитить ключ API Gemini
Оставьте отзыв о работе с Firebase AI Logic