На этой странице представлены ответы на часто задаваемые вопросы (FAQ) и информация по устранению неполадок, связанных с API Gemini и Firebase AI Logic SDK. Если у вас есть другие вопросы, ознакомьтесь с разделом часто задаваемых вопросов по API Gemini в документации Google Cloud .
Панели мониторинга состояния
Vertex AI Gemini API (
Vertex Gemini API
иVertex Imagen API
)
Общие часто задаваемые вопросы
В 2024 году мы выпустили набор клиентских SDK для Firebase, которые могли использовать API Vertex AI Gemini , а также прокси-шлюз Firebase для защиты этого API от злоупотреблений и интеграции с другими продуктами Firebase. Мы назвали наш продукт «Vertex AI в Firebase», и это название точно отражало доступные на тот момент варианты его использования.
Однако с тех пор мы расширили возможности нашего продукта. Например, с мая 2025 года мы предлагаем поддержку Gemini Developer API , включая возможность защиты Gemini Developer API от злоупотреблений с помощью интеграции с Firebase App Check .
В результате название «Vertex AI in Firebase» больше не отражает всю расширенную сферу применения нашего продукта. Поэтому новое название — Firebase AI Logic — лучше отражает наш развивающийся набор функций и позволит нам продолжать расширять наши предложения в будущем!
Ознакомьтесь с руководством по миграции , чтобы убедиться, что вы получаете все новейшие функции Firebase AI Logic (и при желании можете начать использовать Gemini Developer API ).
Вот некоторые различия между двумя поставщиками « Gemini API » в целом, независимо от способа доступа к ним :
API-интерфейс Gemini Developer предлагает «бесплатный уровень» наряду с оплатой по факту использования.
При использовании API Vertex AI Gemini с Firebase AI Logic всегда требуется тарифный план Blaze с оплатой по факту использования.
Обратите внимание, что у двух поставщиков API разные цены на оплату по факту использования (подробнее см. в соответствующей документации).
Ограничения по ставкам (квоты)
API-интерфейс Gemini Developer имеет явные ограничения по скорости.
API Vertex AI Gemini использует «динамическую общую квоту (DSQ)», которую разделяют все пользователи этой модели в данном регионе. При желании можно также настроить выделенную пропускную способность (PT).
Указание места доступа к модели
- Только API Vertex AI Gemini позволяет вам выбирать место доступа к модели.
В следующей таблице перечислены часто задаваемые вопросы о функциях двух поставщиков « Gemini API ». Эта таблица актуальна только при использовании клиентских SDK Firebase AI Logic .
Особенность | API разработчика Gemini | API Vertex AI Gemini |
---|---|---|
Поддержка моделей Gemini | поддерживается | поддерживается |
Поддержка моделей Imagen | поддерживается (пока не для Unity) | поддерживается (пока не для Unity) |
Поддержка моделей Veo | пока не поддерживается | пока не поддерживается |
Поддержка Gemini Live API | пока не поддерживается | поддерживается (Только Android, Flutter и Unity) |
Интеграция с Firebase App Check | поддерживается | поддерживается |
Совместимо с Firebase Remote Config | поддерживается | поддерживается |
Поддержка ИИ-мониторинга в консоли Firebase | пока не поддерживается | поддерживается |
Поддержка URL-адресов Cloud Storage | пока не поддерживается 1 | Публичные файлы и файлы защищены Firebase Security Rules |
Поддержка URL-адресов YouTube и URL-адресов браузера | Только URL-адреса YouTube | URL-адреса YouTube и URL-адреса браузера |
1 API файлов для API разработчика Gemini не поддерживается через Firebase AI Logic SDK.
Да, вы можете включить обоих поставщиков « Gemini API » в своем проекте Firebase, и вы можете использовать оба API в самом приложении.
Чтобы переключаться между поставщиками API в вашем коде, просто убедитесь, что вы правильно настроили внутреннюю службу в своем коде .
Выберите поставщика API Gemini, чтобы просмотреть контент, специфичный для этого поставщика. |
Чтобы использовать Firebase AI Logic SDK с API разработчика Gemini , в вашем проекте должны быть включены следующие два API:
- API разработчика Gemini (
generativelanguage.googleapis.com
) - API логики ИИ Firebase (
firebasevertexai.googleapis.com
)
Вам следует включить эти два API с помощью консоли Firebase :
В консоли Firebase перейдите на страницу Firebase AI Logic .
Нажмите « Начать» .
Выберите, чтобы начать работу с API разработчика Gemini .
Это запустит управляемый рабочий процесс, который включит оба API. Консоль также сгенерирует ключ API Gemini и добавит API Firebase AI Logic в разрешённый список для вашего ключа API Firebase.
Список поддерживаемых моделей см. в разделе « Подробнее о поддерживаемых моделях» . Мы часто добавляем новые возможности в SDK, поэтому следите за обновлениями в разделе часто задаваемых вопросов (а также в примечаниях к выпуску, блогах и публикациях в социальных сетях).
API разработчика Gemini
Вы можете использовать базовые модели Gemini и Imagen .
Обратите внимание, что API разработчика Gemini (независимо от способа доступа к нему) поддерживает только генерацию изображений с помощью imagen-3.0-fast-generate-002
, imagen-4.0-generate-preview-06-06
и imagen-4.0-ultra-generate-preview-06-06
.
API Vertex AI Gemini
Вы можете использовать базовые модели Gemini и Imagen .
Независимо от выбранного вами поставщика API Gemini
Firebase AI Logic не поддерживает следующее:
Нефундаментальные модели Gemini (например, модели PaLM, настроенные модели или модели на основе Gemma).
Старые модели Imagen или
imagen-3.0-capability-001
.
Выпуская стабильную версию модели, мы стремимся обеспечить её доступность как минимум в течение года. Эта «дата выхода из эксплуатации» указана в нескольких местах документации поставщиков API Firebase и Gemini (например, на странице «Модели» документации Firebase ).
После прекращения поддержки модели любые запросы к ней будут завершаться ошибкой 404. По этой причине мы настоятельно рекомендуем настроить и использовать Firebase Remote Config чтобы вы могли динамически изменять модель и версию в своем приложении без выпуска новой версии.
При обновлении приложения для использования новой версии модели мы рекомендуем протестировать его, чтобы убедиться, что ответы по-прежнему соответствуют ожидаемым. Обратите внимание, что при использовании Firebase AI Logic обычно не требуется вносить изменения в код, непосредственно обращающийся к модели.
Вот даты выхода из эксплуатации различных стабильных моделей:
Модели Gemini 1.5 Pro :
-
gemini-1.5-pro-002
(иgemini-1.5-pro
): 24 сентября 2025 г. -
gemini-1.5-pro-001
: 24 мая 2025 г.
-
Модели Gemini 1.5 Flash :
-
gemini-1.5-flash-002
(иgemini-1.5-flash
): 24 сентября 2025 г. -
gemini-1.5-flash-001
: 24 мая 2025 г.
-
Модели Gemini 1.0 Pro Vision : 21 апреля 2025 г. (ранее планировалось на 9 апреля 2025 г.)
Модели Gemini 1.0 Pro : 21 апреля 2025 г. (ранее планировалось на 9 апреля 2025 г.)
По умолчанию Firebase AI Logic устанавливает лимит запросов на пользователя в 100 запросов в минуту (RPM).
Если вы хотите настроить ограничение скорости для каждого пользователя, вам необходимо настроить параметры квоты для API Firebase AI Logic .
Узнайте больше о квоте Firebase AI Logic API . На этой странице вы также можете узнать, как просматривать и редактировать свою квоту.
Действие | Требуемые разрешения IAM | Роли IAM, включающие требуемые разрешения по умолчанию |
---|---|---|
Переход на тарифный план с оплатой по мере использования (Blaze) | firebase.billingPlans.update resourcemanager.projects.createBillingAssignment resourcemanager.projects.deleteBillingAssignment | Владелец |
Включить API в проекте | serviceusage.services.enable | Редактор Владелец |
Создать приложение Firebase | firebase.clients.create | Администратор Firebase Редактор Владелец |
См. Управление данными и ответственный ИИ .
Да, в каждом мультимодальном запросе вы всегда должны предоставлять следующее:
mimeType
файла. См. исключение ниже.Файл. Вы можете предоставить файл как встроенные данные или указать его URL.
Узнайте о поддерживаемых типах входных файлов, о том, как указать тип MIME, а также о двух вариантах предоставления файла в разделе Поддерживаемые входные файлы и требования .
Исключение из включения типа MIME в ваш запрос
Исключением из требования предоставления типа MIME являются встроенные входные данные изображений для запросов от собственных приложений платформ Android и Apple.
Пакеты Firebase AI Logic SDK для платформ 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")
Контекстное кэширование, поиск как инструмент, привязка к поиску Google, выполнение кода, тонкая настройка модели, генерация внедрений и семантический поиск поддерживаются различными моделями или API Vertex AI Gemini , но они недоступны при использовании Firebase AI Logic .
Если вы хотите добавить эти запросы на функции или проголосовать за существующий запрос на функции, посетите Firebase UserVoice .
Часто задаваемые вопросы по ключу API Gemini
Эти часто задаваемые вопросы применимы только в том случае, если вы используете API разработчика Gemini .
API разработчика Gemini использует «ключ API Gemini » для авторизации вызывающего объекта. Поэтому, если вы используете API разработчика Gemini через Firebase AI Logic SDK, вам потребуется действительный ключ API Gemini в вашем проекте Firebase для выполнения вызовов этого API.
«Ключ API Gemini » просто означает ключ API, в списке разрешенных API которого есть API разработчика Gemini .
При настройке Firebase AI Logic в консоли Firebase мы создаём ключ API Gemini , доступный только для Gemini Developer API , и настраиваем прокси-сервис Firebase AI Logic для использования этого ключа API. Этот ключ API Gemini , сгенерированный Firebase, называется Gemini Developer API key (он автоматически создан Firebase) на странице учётных данных консоли Google Cloud .
Узнайте больше об ограничениях API для ключей API .
При использовании Firebase AI Logic SDK ключ API Gemini не добавляется в кодовую базу приложения. Узнайте больше о том, как обеспечить безопасность ключа API Gemini .
При использовании Firebase AI Logic SDK не добавляйте ключ API Gemini в кодовую базу вашего приложения.
Фактически, при разработке с использованием Firebase AI Logic SDK вы не взаимодействуете напрямую с вашим ключом Gemini API. Вместо этого наш прокси-сервис Firebase AI Logic будет автоматически включать ключ Gemini API в каждый запрос к Gemini Developer API — полностью на бэкенде.
При использовании Firebase AI Logic SDK вам вряд ли потребуется менять ключ API Gemini . Однако вот два случая, когда это может потребоваться:
Если вы случайно потеряли ключ и хотите заменить его новым надежным ключом.
Если вы случайно удалили ключ. Обратите внимание, что вы можете восстановить ключ в течение 30 дней с момента удаления.
Вот как изменить ключ API Gemini , используемый пакетами Firebase AI Logic SDK:
Если ваш API-ключ Gemini , сгенерированный Firebase, все еще существует, удалите его.
Вы можете удалить этот ключ API на панели «API и сервисы» > «Учётные данные» консоли Google Cloud . Он называется:
API-ключ разработчика Gemini (автоматически созданный Firebase) .На той же странице консоли Google Cloud создайте новый ключ API. Рекомендуем назвать его примерно так:
API-ключ разработчика Gemini для Firebase .К этому новому ключу API добавьте ограничения API и выберите только API генеративного языка .
«API генеративного языка» — так иногда называют API разработчика Gemini в консоли Google Cloud .Не добавляйте никаких ограничений для приложений , иначе прокси-служба Firebase AI Logic не будет работать должным образом.
Выполните следующую команду, чтобы установить этот новый ключ в качестве ключа API Gemini , который должна использовать прокси-служба Firebase AI Logic .
PROJECT_ID="PROJECT_ID" GENERATIVE_LANGUAGE_API_KEY="DEVELOPER_CREATED_GEMINI_API_KEY" curl \ -X PATCH \ -H "x-goog-user-project: ${PROJECT_ID}" \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://firebasevertexai.googleapis.com/v1beta/projects/${PROJECT_ID}/locations/global/config" \ -d "{\"generativeLanguageConfig\": {\"apiKey\": \"${GENERATIVE_LANGUAGE_API_KEY}\"}}"
Узнайте больше о gcloud CLI .
Не добавляйте этот новый ключ API Gemini в кодовую базу вашего приложения. Узнайте больше о том, как обеспечить безопасность ключа API Gemini .
Нет, вам не следует использовать ваш «ключ API Firebase» в качестве ключа API Gemini . Мы настоятельно рекомендуем не добавлять API Gemini Developer в разрешённый список для вашего ключа API Firebase.
Ваш ключ API Firebase — это ключ API, указанный в файле конфигурации Firebase или объекте, который вы добавляете в кодовую базу своего приложения для подключения к Firebase. Вы можете включать ключ API Firebase в свой код , если используете его только с API, связанными с Firebase (например, Firebase AI Logic ) . Ознакомьтесь с важной информацией о ключах API Firebase .
На панели API и службы > Учетные данные консоли Google Cloud ключи API Firebase выглядят следующим образом:
Поскольку для работы API, связанных с Firebase, необходимо добавить ключ API Firebase в кодовую базу вашего приложения, а API Gemini Developer авторизовано с помощью ключа API, мы настоятельно рекомендуем НЕ добавлять API Gemini Developer (который в консоли Google Cloud называется «Generative Language API») в список разрешённых API для вашего ключа API Firebase . В противном случае вы подвергаете API Gemini Developer потенциальному риску злоупотребления.
В этом разделе часто задаваемых вопросов описываются некоторые рекомендуемые методы обеспечения безопасности вашего ключа API Gemini .
Если вы вызываете API разработчика Gemini непосредственно из своего мобильного или веб-приложения:
- Используйте клиентские SDK Firebase AI Logic .
- Не добавляйте ключ API Gemini в кодовую базу вашего приложения.
Firebase AI Logic предоставляет прокси-сервис, который включает ваш ключ Gemini API в каждый запрос к Gemini Developer API — полностью на внутреннем уровне.
Кроме того, мы настоятельно рекомендуем следующее:
Как только вы начнете серьезно разрабатывать свое приложение, выполните интеграцию с Firebase App Check , чтобы защитить ваши внутренние ресурсы, а также API, используемые для доступа к генеративным моделям.
Не используйте повторно ключ API Gemini , сгенерированный Firebase, вне Firebase AI Logic . Если вам нужен ключ API Gemini для другого случая, создайте отдельный ключ.
В общем случае НЕ следует изменять ключ API Gemini , сгенерированный Firebase. В консоли Google Cloud этот ключ называется Gemini Developer API key (он автоматически создан Firebase) .
Не добавляйте дополнительные API в список разрешённых API для вашего API-ключа Gemini , сгенерированного Firebase. В списке разрешённых API вашего API-ключа Gemini должен быть только API разработчика Gemini (который в консоли Google Cloud называется «Generative Language API»).
Не добавляйте никаких ограничений для приложений , иначе прокси-служба Firebase AI Logic не будет работать должным образом.
Если ваш ключ API Gemini был скомпрометирован, следуйте инструкциям по изменению ключа API Gemini , который используется для вызова API разработчика Gemini .
Также ознакомьтесь с рекомендуемыми методами обеспечения безопасности вашего ключа API Gemini .
Устранение ошибок
Если вы пытаетесь использовать API разработчика Gemini и получаете ошибку 404 с сообщением Firebase AI Logic genai config not found
, это обычно означает, что в вашем проекте Firebase нет действительного ключа API Gemini для использования с клиентскими SDK Firebase AI Logic .
Вот наиболее вероятные причины этой ошибки:
Вы еще не настроили свой проект Firebase для Gemini Developer API .
Что делать:
В консоли Firebase перейдите на страницу Firebase AI Logic . Нажмите «Начать» и выберите Gemini Developer API . Включите API, и консоль настроит ваш проект для Gemini Developer API . После завершения рабочего процесса повторите запрос.Если вы совсем недавно выполнили настройку Firebase AI Logic в консоли Firebase , то ваш ключ API Gemini мог быть еще недоступен для всех требуемых внутренних служб во всех регионах.
Что делать:
Подождите несколько минут и повторите запрос.Ваш ключ API Gemini мог быть удален из вашего проекта Firebase.
Что делать:
Узнайте, как изменить ключ API Gemini , используемый Firebase AI Logic .
Если вы пытаетесь отправить мультимодальный запрос с URL-адресом Cloud Storage for Firebase , вы можете столкнуться со следующей ошибкой 400:
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.
Эта ошибка вызвана тем, что в проекте не были автоматически инициализированы необходимые агенты сервисов при включении API Vertex AI . Это известная проблема некоторых проектов, и мы работаем над её глобальным решением.
Вот обходной путь для исправления вашего проекта и корректной подготовки этих агентов сервисов, чтобы вы могли начать включать URL-адреса Cloud Storage for Firebase в мультимодальные запросы. Вы должны быть владельцем проекта, и вам нужно выполнить этот набор задач для своего проекта только один раз.
Доступ и аутентификация с помощью gcloud CLI .
Проще всего это сделать через Cloud Shell . Подробнее см. в документации Google Cloud .При появлении соответствующего запроса следуйте инструкциям на терминале, чтобы запустить интерфейс gcloud CLI для вашего проекта Firebase.
Вам понадобится идентификатор вашего проекта Firebase, который вы можете найти в верхней части «Настройки проекта» в консоли Firebase .
Подготовьте необходимых агентов служб в своем проекте, выполнив следующую команду:
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/endpoints -d ''
Подождите несколько минут, чтобы убедиться, что агенты служб подготовлены, а затем повторите отправку мультимодального запроса, включающего URL-адрес Cloud Storage for Firebase .
Если эта ошибка все еще появляется после нескольких минут ожидания, обратитесь в службу поддержки Firebase .
Если вы получили ошибку 400 с сообщением API key not valid. Please pass a valid API key.
, это обычно означает, что ключ API в файле/объекте конфигурации Firebase не существует или не настроен для использования с вашим приложением и/или проектом Firebase.
Убедитесь, что ключ API, указанный в файле/объекте конфигурации Firebase, совпадает с ключом API вашего приложения. Все ключи API можно просмотреть на панели «API и сервисы» > «Учётные данные» в консоли Google Cloud .
Если вы обнаружите несоответствие, получите новый файл/объект конфигурации Firebase и замените тот, который находится в вашем приложении. Новый файл/объект конфигурации должен содержать действительный ключ API для вашего приложения и проекта Firebase.
Если вы получили ошибку 403 с сообщением « Requests to this API firebasevertexai.googleapis.com ... are blocked.
, это обычно означает, что в списке разрешенных API ключа API в файле/объекте конфигурации Firebase нет требуемого API для продукта, который вы пытаетесь использовать.
Убедитесь, что API-ключ, используемый вашим приложением, содержит все необходимые API, указанные в списке разрешенных API-ограничений ключа . Для Firebase AI Logic ваш API-ключ должен включать в свой список разрешенных API как минимум Firebase AI Logic .
Вы можете просмотреть все свои ключи API на панели API и службы > Учетные данные в консоли Google Cloud .
Если вы получили ошибку 403 с текстом PERMISSION_DENIED: The caller does not have permission.
, это обычно означает, что ключ API в вашем файле/объекте конфигурации Firebase принадлежит другому проекту Firebase.
Убедитесь, что ключ API, указанный в файле/объекте конфигурации Firebase, совпадает с ключом API вашего приложения. Все ключи API можно просмотреть на панели «API и сервисы» > «Учётные данные» в консоли Google Cloud .
Если вы обнаружите несоответствие, получите новый файл/объект конфигурации Firebase и замените тот, который находится в вашем приложении. Новый файл/объект конфигурации должен содержать действительный ключ API для вашего приложения и проекта Firebase.
Оставьте отзыв о своем опыте работы с Firebase AI Logic
На этой странице представлены ответы на часто задаваемые вопросы (FAQ) и информация по устранению неполадок, связанных с API Gemini и Firebase AI Logic SDK. Если у вас есть другие вопросы, ознакомьтесь с разделом часто задаваемых вопросов по API Gemini в документации Google Cloud .
Панели мониторинга состояния
Vertex AI Gemini API (
Vertex Gemini API
иVertex Imagen API
)
Общие часто задаваемые вопросы
В 2024 году мы выпустили набор клиентских SDK для Firebase, которые могли использовать API Vertex AI Gemini , а также прокси-шлюз Firebase для защиты этого API от злоупотреблений и интеграции с другими продуктами Firebase. Мы назвали наш продукт «Vertex AI в Firebase», и это название точно отражало доступные на тот момент варианты его использования.
Однако с тех пор мы расширили возможности нашего продукта. Например, с мая 2025 года мы предлагаем поддержку Gemini Developer API , включая возможность защиты Gemini Developer API от злоупотреблений с помощью интеграции с Firebase App Check .
В результате название «Vertex AI in Firebase» больше не отражает всю расширенную сферу применения нашего продукта. Поэтому новое название — Firebase AI Logic — лучше отражает наш развивающийся набор функций и позволит нам продолжать расширять наши предложения в будущем!
Ознакомьтесь с руководством по миграции , чтобы убедиться, что вы получаете все новейшие функции Firebase AI Logic (и при желании можете начать использовать Gemini Developer API ).
Вот некоторые различия между двумя поставщиками « Gemini API » в целом, независимо от способа доступа к ним :
API-интерфейс Gemini Developer предлагает «бесплатный уровень» наряду с оплатой по факту использования.
При использовании API Vertex AI Gemini с Firebase AI Logic всегда требуется тарифный план Blaze с оплатой по факту использования.
Обратите внимание, что у двух поставщиков API разные цены на оплату по факту использования (подробнее см. в соответствующей документации).
Ограничения по ставкам (квоты)
API-интерфейс Gemini Developer имеет явные ограничения по скорости.
API Vertex AI Gemini использует «динамическую общую квоту (DSQ)», которую разделяют все пользователи этой модели в данном регионе. При желании можно также настроить выделенную пропускную способность (PT).
Указание места доступа к модели
- Только API Vertex AI Gemini позволяет вам выбирать место доступа к модели.
В следующей таблице перечислены часто задаваемые вопросы о функциях двух поставщиков « Gemini API ». Эта таблица актуальна только при использовании клиентских SDK Firebase AI Logic .
Особенность | API разработчика Gemini | API Vertex AI Gemini |
---|---|---|
Поддержка моделей Gemini | поддерживается | поддерживается |
Поддержка моделей Imagen | поддерживается (пока не для Unity) | поддерживается (пока не для Unity) |
Поддержка моделей Veo | пока не поддерживается | пока не поддерживается |
Поддержка Gemini Live API | пока не поддерживается | поддерживается (Только Android, Flutter и Unity) |
Интеграция с Firebase App Check | поддерживается | поддерживается |
Совместимо с Firebase Remote Config | поддерживается | поддерживается |
Поддержка ИИ-мониторинга в консоли Firebase | пока не поддерживается | поддерживается |
Поддержка URL-адресов Cloud Storage | пока не поддерживается 1 | Публичные файлы и файлы защищены Firebase Security Rules |
Поддержка URL-адресов YouTube и URL-адресов браузера | Только URL-адреса YouTube | URL-адреса YouTube и URL-адреса браузера |
1 API файлов для API разработчика Gemini не поддерживается через Firebase AI Logic SDK.
Да, вы можете включить обоих поставщиков « Gemini API » в своем проекте Firebase, и вы можете использовать оба API в самом приложении.
Чтобы переключаться между поставщиками API в вашем коде, просто убедитесь, что вы правильно настроили внутреннюю службу в своем коде .
Выберите поставщика API Gemini, чтобы просмотреть контент, специфичный для этого поставщика. |
Чтобы использовать Firebase AI Logic SDK с API разработчика Gemini , в вашем проекте должны быть включены следующие два API:
- API разработчика Gemini (
generativelanguage.googleapis.com
) - API логики ИИ Firebase (
firebasevertexai.googleapis.com
)
Вам следует включить эти два API с помощью консоли Firebase :
В консоли Firebase перейдите на страницу Firebase AI Logic .
Нажмите « Начать» .
Выберите, чтобы начать работу с API разработчика Gemini .
Это запустит управляемый рабочий процесс, который включит оба API. Консоль также сгенерирует ключ API Gemini и добавит API Firebase AI Logic в разрешённый список для вашего ключа API Firebase.
Список поддерживаемых моделей см. в разделе « Подробнее о поддерживаемых моделях» . Мы часто добавляем новые возможности в SDK, поэтому следите за обновлениями в разделе часто задаваемых вопросов (а также в примечаниях к выпуску, блогах и публикациях в социальных сетях).
API разработчика Gemini
Вы можете использовать базовые модели Gemini и Imagen .
Обратите внимание, что API разработчика Gemini (независимо от способа доступа к нему) поддерживает только генерацию изображений с помощью imagen-3.0-fast-generate-002
, imagen-4.0-generate-preview-06-06
и imagen-4.0-ultra-generate-preview-06-06
.
API Vertex AI Gemini
Вы можете использовать базовые модели Gemini и Imagen .
Независимо от выбранного вами поставщика API Gemini
Firebase AI Logic не поддерживает следующее:
Нефундаментальные модели Gemini (например, модели PaLM, настроенные модели или модели на основе Gemma).
Старые модели Imagen или
imagen-3.0-capability-001
.
Когда мы выпускаем стабильную модельную версию, мы стремимся убедиться, что она доступна как минимум один год. Мы перечислим эту «дату выхода на пенсию» в нескольких местах в документации Firebase и API Gemini API (например, на странице «Модели» документации Firebase ).
Когда модель выходит на пенсию, любые запросы на эту модель потерпят неудачу с ошибкой 404. По этой причине мы настоятельно рекомендуем настроить и использовать Firebase Remote Config , чтобы вы могли динамически изменить модель и версию в своем приложении, не выпустив новую версию вашего приложения.
Когда вы обновляете свое приложение для использования новой версии модели, мы рекомендуем тестировать ваше приложение, чтобы убедиться, что ответы все еще как и ожидалось. Обратите внимание, что при использовании Firebase AI Logic обычно не требуется никакой модификации для любого из кода, который фактически вызывает модель.
Вот даты выхода на пенсию для различных стабильных моделей:
Gemini 1.5 Pro Models:
-
gemini-1.5-pro-002
(иgemini-1.5-pro
): 24 сентября 2025 г. -
gemini-1.5-pro-001
: 24 мая 2025 г.
-
Flash Models Gemini 1.5 :
-
gemini-1.5-flash-002
(иgemini-1.5-flash
): 24 сентября 2025 г. -
gemini-1.5-flash-001
: 24 мая 2025 г.
-
Модели Gemini 1.0 Pro Vision : 21 апреля 2025 года (ранее запланировано на 9 апреля 2025 года)
Gemini 1.0 Pro Models: 21 апреля 2025 года (ранее запланировано на 9 апреля 2025 года)
По умолчанию логика AI Firebase устанавливает лимит запроса на пользователя по 100 запросов в минуту (обороты).
Если вы хотите настроить свой предел ставки для каждого пользователя, вам необходимо настроить настройки квоты для API Logic AI Firebase .
Узнайте больше о квоте API API Firebase AI . На этой странице вы также можете узнать, как просматривать и отредактировать свою квоту.
Действие | Требуются разрешения IAM | IAM Роль (ы), которые по умолчанию включают необходимые разрешения |
---|---|---|
Обновление платеж на платеж на платеж как выугольник (пламен) | firebase.billingPlans.update resourcemanager.projects.createBillingAssignment resourcemanager.projects.deleteBillingAssignment | Владелец |
Включить API в проекте | serviceusage.services.enable | Редактор Владелец |
Создать приложение Firebase | firebase.clients.create | Администрация Firebase Редактор Владелец |
См. Управление данными и ответственный ИИ .
Да, в каждом мультимодальном запросе вы всегда должны предоставить следующее:
mimeType
файла. Смотрите исключение ниже.Файл. Вы можете либо предоставить файл как встроенные данные, либо предоставить файл, используя его URL.
Узнайте о поддерживаемых типах входных файлов, о том, как указать тип MIME и два варианта предоставления файла в поддерживаемых входных файлах и требованиях .
Исключение из включения типа MIME в ваш запрос
Исключением для предоставления типа MIME является входные входы изображений для запросов из нативных приложений Android и Apple Platform.
SDKS Firebase AI Logic SDK для Android и Apple Platforms предоставляют упрощенный и удобный способ обработки изображений в запросах-все изображения (независимо от их формата) преобразуются на сторону клиента в JPEG с качеством 80% до отправки на сервер. Это означает, что когда вы предоставляете изображения в качестве встроенных данных, используя SDK Android и Apple Platforms, вам не нужно указывать тип MIME в запросе .
Эта упрощенная обработка показана в документации по логике Firebase AI в примерах для отправки изображений 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")
Контекстное кэширование, поиск в качестве инструмента, заземление с поиском Google, выполнение кода, тонкая настройка модели, генерация внедрения и семантическое поиск поддерживается различными моделями или API Vertex AI Gemini , но они недоступны при использовании Logic Firebase AI .
Если вы хотите добавить их в качестве запросов функций или проголосовать по существующему запросу на функции, посетите Firebase Uservoice .
Gemini API -ключа FAQ
Эти часто задаваемые вопросы применимы только в том случае, если вы используете API разработчика Gemini .
API Developer Gemini использует «ключ API Gemini », чтобы разрешить абонента. Таким образом, если вы используете API API разработчика Gemini через SDK Firebase AI Logic , то вам нужен допустимый ключ API Gemini в вашем проекте Firebase, чтобы вызовать этот API.
«Ключ API Gemini » просто означает ключ API, который имеет API Developer Gemini в своем API Allist.
Когда вы проходите через рабочую процесс настройки Firebase AI Logic в консоли Firebase , мы создаем ключ API Gemini , который ограничен только API разработчика Gemini , и мы настроили службу Logic AI Firebase AI для использования этого ключа API. Этот ключ API, сгенерированный Firebase Gemini , называется API-ключ Developer Gemini (автоматически созданный Firebase) на странице учетных данных Google Cloud .
Узнайте больше об ограничениях API для ключей API .
Вы не добавляете свой ключ API Gemini в кодовую базу вашего приложения при использовании SDK Firebase AI Logic . Узнайте больше о том, как обеспечить безопасность вашего ключа API Gemini .
При использовании SDKS Firebase AI Logic SDK не добавляйте свой ключ API Gemini в кодовую базу вашего приложения.
Фактически, при разработке с логикой AI Firebase вы напрямую не взаимодействуете с вашим ключом API Gemini . Вместо этого наша служба прокси -сервера Firebase AI Logic будет внутренне включать в себя ключ API Gemini в каждом запросе к API разработчика Gemini - полностью в бэкэнде.
При использовании SDKS Firebase AI Logic SDK маловероятно, что вам нужно изменить свой ключ API Gemini . Тем не менее, вот два случая, когда вам может потребоваться:
Если вы случайно просочились ключом и хотите заменить его новым безопасным ключом.
Если вы случайно удалили ключ. Обратите внимание, что вы можете не удалить ключ в течение 30 дней после удаления.
Вот как вы меняете ключ API Gemini , который используется SDKS Firebase AI Logic :
Если ваш API-ключ, сгенерированный пожарной базой, все еще существует, удалите его.
Вы можете удалить этот ключ API в APIS & Services > Панель учетных данных из Google Cloud . Это названо:
Gemini Developer API -ключ (авто, созданный Firebase) .На той же странице Google Cloud Console создайте новый ключ API. Мы предлагаем назвать это чем -то вроде:
Разработчик Gemini API для Firebase .В этот новый ключ API добавьте ограничения API и выберите только Generative Language API .
«Generative Language API» - это то, что иногда называют API разработчика Близнецов в Google Cloud .Не добавляйте никаких ограничений приложений ; В противном случае прокси -сервис AI Firebase AI не будет работать, как и ожидалось.
Запустите следующую команду, чтобы установить этот новый ключ в качестве ключа API Gemini , который должен использовать службу Logic AI Firebase AI .
PROJECT_ID="PROJECT_ID" GENERATIVE_LANGUAGE_API_KEY="DEVELOPER_CREATED_GEMINI_API_KEY" curl \ -X PATCH \ -H "x-goog-user-project: ${PROJECT_ID}" \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://firebasevertexai.googleapis.com/v1beta/projects/${PROJECT_ID}/locations/global/config" \ -d "{\"generativeLanguageConfig\": {\"apiKey\": \"${GENERATIVE_LANGUAGE_API_KEY}\"}}"
Узнайте о gcloud CLI .
Обязательно добавьте этот новый ключ API Gemini в кодовую базу вашего приложения. Узнайте больше о том, как обеспечить безопасность вашего ключа API Gemini .
Нет - вы не должны использовать свой ключ «API Firebase API» в качестве ключа API Gemini . Мы настоятельно рекомендуем вам не добавлять API разработчика Близнецов в AllistList для вашего ключа API Firebase.
Ваша ключ API Firebase - это ключ API, который указан в вашем файле конфигурации Firebase или объекта, который вы добавляете в кодовую базу вашего приложения для подключения вашего приложения к Firebase. Можно включить свой ключ API Firebase API в свой код , когда вы используете ключ только с API-интерфейсом, связанной с Firebase (например, логика AI Firebase ) . Изучите важную информацию о клавишах API Firebase .
В панели APIS & Services > Учетные данные Google Cloud это то, на что выглядят клавиши API Firebase API:
Поскольку вам необходимо добавить свой ключ API Firebase API в кодовую базу вашего приложения для API, связанных с Firebase, и поскольку API разработчика Gemini Developmer авторизован с помощью API-ключа, мы настоятельно рекомендуем вам не добавлять API Deviler Gemini (называемый «Generative Language API» на консоли Google Cloud ) в API-allist для вашего ключа Firebase API . Если вы это сделаете, то вы подвергаете API разработчика Близнецов на потенциальное злоупотребление.
Этот FAQ описывает некоторые рекомендуемые лучшие практики, чтобы обеспечить безопасность вашего ключа API Gemini .
Если вы звоните в API разработчика Gemini непосредственно из своего мобильного или веб -приложения:
- Используйте SDKS Firebase AI Logic Client SDK.
- Не добавляйте свой ключ API Gemini в кодовую базу вашего приложения.
Firebase AI Logic предоставляет прокси -сервис, который внутренне включает ваш ключ API Gemini в каждом запросе на API разработчика Gemini - полностью в бэкэнде.
Кроме того, мы настоятельно рекомендуем следующее:
Как только вы начнете серьезно развивать свое приложение, интегрируйтесь с Firebase App Check , чтобы помочь защитить ваши бэкэнд -ресурсы, а также API, используемые для доступа к генеративным моделям.
Не используйте сгенерированный огненной базой API-ключом Gemini за пределами логики AI Firebase . Если вам нужен ключ API Gemini для другого варианта использования, создайте отдельный ключ.
В общем, вы не должны изменять ключ API, сгенерированного Firebase API. Этот ключ называется API -ключ Developer Gemini (автоматически созданный Firebase) в консоли Google Cloud .
Не добавляйте никаких дополнительных API в API AllistList для вашего клавиша API, созданного Firebase API. В своем API AllistList ваш ключ API Gemini должен иметь только API разработчика Gemini (называемый «Generative Language API» в консоли Google Cloud ).
Не добавляйте никаких ограничений приложений ; В противном случае прокси -сервис AI Firebase AI не будет работать, как и ожидалось.
Если ваш ключ API Gemini был скомпрометирован, следуйте инструкциям, чтобы изменить ключ API Gemini , который используется для вызова API разработчика Близнецов .
Кроме того, просмотрите рекомендуемые лучшие практики, чтобы обеспечить безопасность вашего ключа API Gemini .
Устранение ошибок
Если вы пытаетесь использовать API Developer Gemini Developer и получаете ошибку 404, в которой говорится, что Firebase AI Logic genai config not found
, это обычно означает, что ваш проект Firebase не имеет достоверного ключа API Gemini для использования с SDK Firebase AI Logic SDK.
Вот наиболее вероятные причины этой ошибки:
Вы еще не настроили свой проект Firebase для API разработчика Близнецов .
Что делать:
В консоли Firebase перейдите на страницу Logic Firebase AI . Нажмите «Начало работы» , а затем выберите API разработчика Gemini Developer . Включите API, и консоль настроит ваш проект для API разработчика Gemini . После завершения рабочего процесса попробуйте снова свой запрос.Если вы совсем недавно прошли рабочий процесс настройки Logic Firebase AI в консоли Firebase , то ваш ключ API Gemini может еще не быть доступен для всех требуемых бэкэнд -служб во всех регионах.
Что делать:
Подождите несколько минут, а затем попробуйте запрос снова.Ваш ключ API Gemini мог быть удален из вашего проекта Firebase.
Что делать:
Узнайте, как изменить ключ API Gemini , используемый Logic Firebase AI .
Если вы пытаетесь отправить мультимодальный запрос с Cloud Storage for Firebase , вы можете встретить следующие 400 ошибок:
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.
Эта ошибка вызвана проектом, который не имел необходимых сервисных агентов правильно, когда в проекте был включен API Vertex AI AI . Это известная проблема с некоторыми проектами, и мы работаем над глобальным исправлением.
Вот обходной путь, чтобы исправить ваш проект и правильно предоставить эти агенты по обслуживанию, чтобы вы могли начать, включая Cloud Storage for Firebase в ваши мультимодальные запросы. Вы должны быть владельцем проекта, и вам нужно выполнить этот набор задач только один раз для вашего проекта.
Доступ и аутентификация с gcloud CLI .
Самый простой способ сделать это - из Cloud Shell . Узнайте больше в документации Google Cloud .Если будет предложено, следуйте инструкциям, отображаемым в терминале, чтобы gcloud CLI работал против вашего проекта Firebase.
Вам понадобится ваш идентификатор проекта Firebase, который вы можете найти в верхней части проекта настройки в консоли Firebase .
Предоставьте необходимые агенты обслуживания в вашем проекте, выполнив следующую команду:
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/endpoints -d ''
Подождите несколько минут, чтобы убедиться, что сервисные агенты будут предоставлены, а затем повторите попытку отправки вашего мультимодального запроса, который включает в себя Cloud Storage for Firebase .
Если вы все еще получаете эту ошибку после нескольких минут ожидания, обратитесь к поддержке Firebase .
Если вы получили ошибку 400, которая говорит, что API key not valid. Please pass a valid API key.
Обычно это означает, что ключ API в вашем файле/объекте конфигурации Firebase не существует или не настраивается для использования с вашим приложением и/или проектом Firebase.
Убедитесь, что ключ API, указанный в вашем файле/объекте конфигурации Firebase, соответствует клавишу API для вашего приложения. Вы можете просмотреть все свои ключи API в панели API и служб > Панель учетных данных в консоли Google Cloud .
Если вы обнаружите, что они не совпадают, затем получите новый файл/объект конфигурации Firebase , а затем замените тот, который находится в вашем приложении. Свежий файл/объект конфигурации должен содержать действительный ключ API для вашего приложения и проекта Firebase.
Если вы получили ошибку 403, в которой говорится, что Requests to this API firebasevertexai.googleapis.com ... are blocked.
Обычно это означает, что ключ API в вашем файле/объекте конфигурации Firebase не имеет требуемого API в своем списке Allist для продукта, который вы пытаетесь использовать.
Убедитесь, что ключ API, используемый вашим приложением, имеет все необходимые API, включенные в «Ограничения API API» . Для логики AI Firebase ваш ключ API должен иметь как минимум API API Firebase AI AI в своем списке.
Вы можете просмотреть все свои ключи API в панели API и служб > Панель учетных данных в консоли Google Cloud .
Если вы получаете ошибку 403, которая говорит, что PERMISSION_DENIED: The caller does not have permission.
, обычно это означает, что ключ API в вашем файле/объекте конфигурации Firebase принадлежит к другому проекту Firebase.
Убедитесь, что ключ API, указанный в вашем файле/объекте конфигурации Firebase, соответствует клавишу API для вашего приложения. Вы можете просмотреть все свои ключи API в панели API и служб > Панель учетных данных в консоли Google Cloud .
Если вы обнаружите, что они не совпадают, затем получите новый файл/объект конфигурации Firebase , а затем замените тот, который находится в вашем приложении. Свежий файл/объект конфигурации должен содержать действительный ключ API для вашего приложения и проекта Firebase.
Дайте обратную связь о своем опыте с логикой Firebase AI