Часто задаваемые вопросы и устранение неполадок

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

Почему название было изменено с «Vertex AI in Firebase» на « Firebase AI Logic »?

В 2024 году мы запустили набор клиентских SDK Firebase, которые могли использовать API Vertex AI Gemini , а также шлюз-прокси Firebase для защиты этого API от злоупотреблений и обеспечения интеграции с другими продуктами Firebase. Мы назвали наш продукт «Vertex AI in 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 Developer API и Vertex AI Gemini API ?

Вот некоторые различия между двумя поставщиками « Gemini API » в целом, независимо от способа доступа к ним :

• Ценообразование

  • API-интерфейс Gemini Developer предлагает «бесплатный уровень» наряду с оплатой по факту использования.

  • При использовании API Vertex AI Gemini с Firebase AI Logic всегда требуется тарифный план Blaze с оплатой по факту использования.

  Обратите внимание, что у двух поставщиков API разные цены на оплату по факту использования (подробнее см. в соответствующей документации).

• Ограничения по ставкам (квота)

  • API разработчика Gemini имеет явные ограничения по скорости.

  • API Vertex AI Gemini использует «динамическую общую квоту (DSQ)», которую разделяют все, кто использует эту модель в этом регионе. Вы также можете опционально настроить выделенную пропускную способность (PT).

• Указание места доступа к модели

  • Только API Vertex AI Gemini позволяет вам выбирать место доступа к модели.

В следующей таблице перечислены возможности часто запрашиваемых функций для двух поставщиков " Gemini API ". Эта таблица применяется конкретно при использовании Firebase AI Logic client SDKs .

¹ API файлов для API разработчика Gemini не поддерживается через Firebase AI Logic SDK.

Могу ли я использовать одновременно Gemini Developer API и Vertex AI Gemini API ?

Да, вы можете включить обоих поставщиков « Gemini API » в своем проекте Firebase, и вы можете использовать оба API в самом приложении.

Чтобы переключаться между поставщиками API в вашем коде, просто убедитесь, что вы правильно настроили внутреннюю службу в своем коде .

Какие API необходимы? И как их включить?

Чтобы использовать Firebase AI Logic SDK с Gemini Developer API , в вашем проекте должны быть включены следующие два API:

• API разработчика Gemini ( generativelanguage.googleapis.com )
• API логики Firebase AI ( firebasevertexai.googleapis.com )

Вам следует включить эти два API с помощью консоли Firebase :

1. В консоли Firebase перейдите на страницу Firebase AI Logic .

2. Нажмите « Начать» .

3. Выберите, чтобы начать работу с API разработчика Gemini .

   Это запустит управляемый рабочий процесс, который включит для вас два API. Консоль также сгенерирует ключ API Gemini , а также добавит API Firebase AI Logic в список разрешенных для вашего ключа API Firebase.

Какие модели можно использовать с Firebase AI Logic SDK?

• Вы можете использовать любую из моделей Gemini и Imagen 3 foundation с Firebase AI Logic SDK, включая предварительные и экспериментальные версии. Список этих моделей см. в разделе Learn about supported models .

• С Firebase AI Logic SDK нельзя использовать небазовые модели Gemini (например, модели PaLM, настроенные модели или модели на основе Gemma).

  Firebase AI Logic также не поддерживает старые модели Imagen или imagen-3.0-capability-001 .

• API разработчика Gemini (независимо от способа доступа) не поддерживает imagen-3.0-fast-generate-001 или более старую версию imagen-3.0-generate-001 .

Мы часто добавляем новые возможности в SDK, поэтому следите за обновлениями в этом разделе часто задаваемых вопросов (а также в примечаниях к выпуску, блогах и сообщениях в социальных сетях).

Что делать, когда модели выходят на пенсию?

Когда мы выпускаем стабильную версию модели, мы стремимся обеспечить ее доступность в течение как минимум одного года. Мы указываем эту «дату выхода на пенсию» в нескольких местах в документации Firebase и Google Cloud (например, на странице «Модели» ).

Когда модель удаляется, любые запросы к этой модели будут завершаться ошибкой 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 . На этой странице вы также можете узнать, как просматривать и редактировать свою квоту.

Какие разрешения необходимы для использования Firebase AI Logic SDK?

Использует ли Firebase AI Logic мои данные для обучения моделей?

См. Управление данными и ответственный ИИ .

Требуется ли тип MIME в моих мультимодальных запросах? (например, для изображений, PDF-файлов, видео и аудиовхода)

Да, в каждом мультимодальном запросе вы всегда должны предоставлять следующее:

• 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")

Доступны ли эти функции при использовании Firebase AI Logic ? Кэширование контекста, поиск как инструмент, заземление с помощью поиска Google, выполнение кода, тонкая настройка модели, генерация внедрений и семантический поиск?

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

Если вы хотите добавить их в качестве запросов на функции или проголосовать за существующий запрос на функции, посетите Firebase UserVoice .

Что такое 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. Этот сгенерированный Firebase ключ API Gemini называется ключом API Gemini Developer (автоматически созданным Firebase) на странице учетных данных консоли Google Cloud .

Узнайте больше об ограничениях API для ключей API .

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

Как изменить ключ Gemini API, используемый для вызова Gemini Developer API ?

При использовании Firebase AI Logic SDK вам вряд ли понадобится менять ключ API Gemini . Однако вот два случая, когда это может потребоваться:

• Если вы случайно потеряли ключ и хотите заменить его новым безопасным ключом.

• Если вы случайно удалили ключ. Обратите внимание, что вы можете восстановить ключ в течение 30 дней с момента удаления.

Вот как изменить ключ API Gemini , используемый Firebase AI Logic SDK:

1. Если ваш API-ключ Gemini , сгенерированный Firebase, все еще существует, удалите его.

   Вы можете удалить этот ключ API на панели API и службы > Учетные данные консоли Google Cloud . Он называется:
   API-ключ разработчика Gemini (автоматически создан Firebase) .

2. На той же странице консоли Google Cloud создайте новый ключ API. Мы предлагаем назвать его как-то так:
   API-ключ разработчика Gemini для Firebase .

3. К этому новому ключу API добавьте ограничения API и выберите только API генеративного языка .
   «Generative Language API» — так иногда называют API разработчика Gemini в консоли Google Cloud .

   Не добавляйте никаких ограничений для приложений , иначе прокси-служба Firebase AI Logic не будет работать должным образом.

4. Выполните следующую команду, чтобы установить этот новый ключ в качестве ключа 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 ?

Нет — вам не следует использовать ваш «Firebase API key» в качестве ключа Gemini API. Мы настоятельно рекомендуем вам не добавлять Gemini Developer API в список разрешенных для вашего ключа Firebase API.

Ваш ключ 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 (называемый «Generative Language API» в консоли Google Cloud ) в список разрешенных API для вашего ключа API Firebase . Если вы это сделаете, то вы подвергаете API Gemini Developer потенциальному злоупотреблению.

Как обеспечить безопасность моего ключа API Gemini ?

В этом разделе часто задаваемых вопросов описываются некоторые рекомендуемые методы обеспечения безопасности вашего ключа API Gemini .

Если вы вызываете API разработчика Gemini напрямую из своего мобильного или веб-приложения:

• Используйте клиентские SDK Firebase AI Logic .
• Не добавляйте ключ API Gemini в кодовую базу вашего приложения.

Firebase AI Logic предоставляет прокси-сервис, который внутренне включает ваш ключ Gemini API в каждый запрос к Gemini Developer API — полностью на бэкэнде.

Кроме того, мы настоятельно рекомендуем следующее:

• Как только вы начнете серьезно разрабатывать свое приложение, выполните интеграцию с Firebase App Check , чтобы защитить ваши внутренние ресурсы, а также API, используемые для доступа к генеративным моделям.

• Не используйте повторно сгенерированный Firebase ключ API Gemini вне Firebase AI Logic . Если вам нужен ключ API Gemini для другого варианта использования, создайте отдельный ключ.

• В общем случае НЕ следует изменять сгенерированный Firebase ключ API Gemini . Этот ключ называется Gemini Developer API key (автоматически создан Firebase) в консоли Google Cloud .

  • Не добавляйте никаких дополнительных API в список разрешенных API для вашего ключа API Gemini , сгенерированного Firebase. В своем списке разрешенных API ваш ключ API Gemini должен иметь только API разработчика Gemini (называемый "Generative Language API" в консоли Google Cloud ).

  • Не добавляйте никаких ограничений для приложений , иначе прокси-служба Firebase AI Logic не будет работать должным образом.

Мой ключ API Gemini был скомпрометирован. Что мне нужно сделать?

Если ваш ключ API Gemini был скомпрометирован, следуйте инструкциям по изменению ключа API Gemini , который используется для вызова API разработчика Gemini .

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

Как исправить эту ошибку 404? Firebase AI Logic genai config not found

Если вы пытаетесь использовать Gemini Developer API и получаете ошибку 404 с сообщением Firebase AI Logic genai config not found , это обычно означает, что в вашем проекте Firebase нет действительного ключа Gemini API для использования с клиентскими SDK Firebase AI Logic .

Вот наиболее вероятные причины этой ошибки:

• Вы еще не настроили свой проект Firebase для Gemini Developer API .

  Что делать:
  В консоли Firebase перейдите на страницу Firebase AI Logic . Нажмите Get started , а затем выберите Gemini Developer API . Включите API, и консоль настроит ваш проект для Gemini Developer API . После завершения рабочего процесса повторите запрос.

• Если вы совсем недавно выполнили настройку Firebase AI Logic в консоли Firebase , то ваш ключ API Gemini мог быть еще не доступен для всех требуемых внутренних служб во всех регионах.

  Что делать:
  Подождите несколько минут, а затем повторите запрос.

• Ваш ключ API Gemini мог быть удален из проекта Firebase.

  Что делать:
  Узнайте, как изменить ключ API Gemini , используемый Firebase AI Logic .

Как исправить эту ошибку 400? Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

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

1. Доступ и аутентификация с помощью gcloud CLI .
   Самый простой способ сделать это — через Cloud Shell . Подробнее читайте в документации Google Cloud .

2. При появлении соответствующего запроса следуйте инструкциям, отображаемым в терминале, чтобы запустить интерфейс gcloud CLI для вашего проекта Firebase.

   Вам понадобится идентификатор вашего проекта Firebase, который вы можете найти в верхней части settings «Параметры проекта» в консоли Firebase .

3. Подготовьте необходимые сервисные агенты в вашем проекте, выполнив следующую команду:

   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 ''
   

4. Подождите несколько минут, чтобы убедиться, что агенты сервиса подготовлены, а затем повторите отправку мультимодального запроса, включающего URL-адрес Cloud Storage for Firebase .

Если эта ошибка все еще появляется после нескольких минут ожидания, обратитесь в службу поддержки Firebase .

Как исправить эту ошибку 400? API key not valid. Please pass a valid API key.

Если вы получили ошибку 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.

Если вы получили ошибку 403 с сообщением « Requests to this API firebasevertexai.googleapis.com ... are blocked. , это обычно означает, что ключ API в вашем файле/объекте конфигурации Firebase не имеет требуемого API в своем списке разрешений для продукта, который вы пытаетесь использовать.

Убедитесь, что API-ключ, используемый вашим приложением, имеет все требуемые API, включенные в список разрешенных API-ограничений ключа . Для Firebase AI Logic ваш API-ключ должен иметь как минимум Firebase AI Logic API в своем списке разрешенных API.

Вы можете просмотреть все свои ключи API на панели API и службы > Учетные данные в консоли Google Cloud .

Как исправить эту ошибку 403? PERMISSION_DENIED: The caller does not have permission.

Если вы получили ошибку 403 с текстом PERMISSION_DENIED: The caller does not have permission. , это обычно означает, что ключ API в вашем файле/объекте конфигурации Firebase принадлежит другому проекту Firebase.

Проверьте, что ключ API, указанный в файле/объекте конфигурации Firebase, соответствует ключу API для вашего приложения. Вы можете просмотреть все свои ключи API на панели API и службы > Учетные данные в консоли Google Cloud .

Если вы обнаружите, что они не совпадают, то получите свежий файл/объект конфигурации Firebase , а затем замените тот, который находится в вашем приложении. Свежий файл/объект конфигурации должен содержать действительный ключ API для вашего приложения и проекта Firebase.

• Для 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, выполнение кода, тонкая настройка модели, генерация встраивания и семантическое поиск?

Контекстное кэширование, поиск в качестве инструмента, заземление с поиском Google, выполнение кода, тонкая настройка модели, генерация внедрения и семантическое поиск поддерживается различными моделями или API Vertex AI Gemini , но они недоступны при использовании Logic Firebase AI .

Если вы хотите добавить их в качестве запросов функций или проголосовать по существующему запросу на функции, посетите Firebase Uservoice .

Что такое ключ 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 .

Должен ли я добавить свой ключ API Gemini в кодовую базу моего мобильного или веб -приложения?

При использовании SDKS Firebase AI Logic SDK не добавляйте свой ключ API Gemini в кодовую базу вашего приложения.

Фактически, при разработке с логикой AI Firebase вы напрямую не взаимодействуете с вашим ключом API Gemini . Вместо этого наша служба прокси -сервера Firebase AI Logic будет внутренне включать в себя ключ API Gemini в каждом запросе к API разработчика Gemini - полностью в бэкэнде.

Как я могу изменить ключ Gemini API, используемый для вызова API разработчика Близнецов ?

При использовании SDKS Firebase AI Logic SDK маловероятно, что вам нужно изменить свой ключ API Gemini . Тем не менее, вот два случая, когда вам может потребоваться:

• Если вы случайно просочились ключом и хотите заменить его новым безопасным ключом.

• Если вы случайно удалили ключ. Обратите внимание, что вы можете не удалить ключ в течение 30 дней после удаления.

Вот как вы меняете ключ API Gemini , который используется SDKS Firebase AI Logic :

1. Если ваш API-ключ, сгенерированный пожарной базой, все еще существует, удалите его.

   Вы можете удалить этот ключ API в APIS & Services > Панель учетных данных из Google Cloud . Это названо:
   Gemini Developer API -ключ (авто, созданный Firebase) .

2. На той же странице Google Cloud Console создайте новый ключ API. Мы предлагаем назвать это чем -то вроде:
   Разработчик Gemini API для Firebase .

3. В этот новый ключ API добавьте ограничения API и выберите только Generative Language API .
   «Generative Language API» - это то, что иногда называют API разработчика Близнецов в Google Cloud .

   Не добавляйте никаких ограничений приложений ; В противном случае прокси -сервис AI Firebase AI не будет работать, как и ожидалось.

4. Запустите следующую команду, чтобы установить этот новый ключ в качестве ключа 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 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 разработчика Близнецов на потенциальное злоупотребление.

Как мне обеспечить безопасным ключ API Gemini ?

Этот 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 Gemini , который используется для вызова API разработчика Близнецов .

Кроме того, просмотрите рекомендуемые лучшие практики, чтобы обеспечить безопасность вашего ключа API Gemini .

Как исправить эту ошибку 404? Firebase AI Logic genai config not found

Если вы пытаетесь использовать 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 .

Как исправить эту ошибку 400? Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

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

1. Доступ и аутентификация с gcloud CLI .
   Самый простой способ сделать это - из Cloud Shell . Узнайте больше в документации Google Cloud .

2. Если будет предложено, следуйте инструкциям, отображаемым в терминале, чтобы gcloud CLI работал против вашего проекта Firebase.

   Вам понадобится ваш идентификатор проекта Firebase, который вы можете найти в верхней части settings проекта настройки в консоли Firebase .

3. Предоставьте необходимые агенты обслуживания в вашем проекте, выполнив следующую команду:

   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 ''
   

4. Подождите несколько минут, чтобы убедиться, что сервисные агенты будут предоставлены, а затем повторите попытку отправки вашего мультимодального запроса, который включает в себя Cloud Storage for Firebase .

Если вы все еще получаете эту ошибку после нескольких минут ожидания, обратитесь к поддержке Firebase .

Как исправить эту ошибку 400? API key not valid. Please pass a valid API key.

Если вы получили ошибку 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.

Если вы получили ошибку 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.

Если вы получаете ошибку 403, которая говорит, что PERMISSION_DENIED: The caller does not have permission. , обычно это означает, что ключ API в вашем файле/объекте конфигурации Firebase принадлежит к другому проекту Firebase.

Убедитесь, что ключ API, указанный в вашем файле/объекте конфигурации Firebase, соответствует клавишу API для вашего приложения. Вы можете просмотреть все свои ключи API в панели API и служб > Панель учетных данных в консоли Google Cloud .

Если вы обнаружите, что они не совпадают, затем получите новый файл/объект конфигурации Firebase , а затем замените тот, который находится в вашем приложении. Свежий файл/объект конфигурации должен содержать действительный ключ API для вашего приложения и проекта Firebase.