Коды ошибок

Ошибка 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 можно посмотреть на панели APIs & Services (API и сервисы) > Credentials (Учетные данные) в консоли Google Cloud.

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

Ошибка 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 Agent Platform. Это известная проблема, которая возникает в некоторых проектах. Мы работаем над ее устранением.

Ниже описано, как исправить проект и правильно настроить этих сервисных агентов, чтобы вы могли добавлять 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.

Ошибка 403: PERMISSION_DENIED: To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check

Если вы получили ошибку 403 - PERMISSION_DENIED с сообщением To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check, это означает, что в вашем запросе нет действительного токена App Check и вы пытаетесь получить доступ к модели, которая часто используется не по назначению.

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

Поскольку для Firebase AI Logic не применяется правило App Check, ваш проект уязвим для злоупотребления этими моделями. Чтобы защитить разработчиков, Firebase блокирует доступ к этим моделям, если в запросе нет действительного токена App Check (то есть App Check применяется для Firebase AI Logic).

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

1. Настройте App Check для пользователя Firebase AI Logic. При локальной разработке убедитесь, что вы настроили App Check поставщика для отладки.

   Применение App Check необходимо для защиты моделей Gemini API и Gemini от злоупотреблений. Чтобы устранить эту ошибку, нужно включить .

2. Отправьте запрос из приложения в Firebase AI Logic ещё раз.

   В этом запросе будет действительный токен App Check, и ошибка 403 - PERMISSION_DENIED больше не появится.

3. Прежде чем выпускать приложение для конечных пользователей, вам нужно настроить поставщика подтверждения для рабочей версии (например, App Attest, Play Integrity или reCAPTCHA Enterprise), чтобы конечные пользователи могли получить доступ к функции ИИ, когда App Check будет включено.

Ошибка 403: PERMISSION_DENIED: Firebase AI Logic has been deactivated in this project. To resume using Firebase AI Logic, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check

Если вы получили ошибку 403 - PERMISSION_DENIED с сообщением Firebase AI Logic has been deactivated in this project. To resume using Firebase AI Logic, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check, это означает, что ваш проект Firebase был признан неактивным и для Firebase AI Logic не применяется правило App Check.

Неактивными считаются проекты, в которых включен Firebase AI Logic, но в последнее время он не использовалсяFirebase AI Logic.

Поскольку для Firebase AI Logic не применяется правило App Check, ваш проект уязвим для злоупотреблений Gemini API. Чтобы защитить ваш проект, Firebase отключил использование Firebase AI Logic, пока вы не включите App Check для Firebase AI Logic.

Когда вы будете готовы снова использовать Firebase AI Logic, выполните следующие действия:

1. Настройте App Check для пользователя Firebase AI Logic. При локальной разработке убедитесь, что вы настроили App Check поставщика для отладки.

   Применение App Check необходимо для защиты моделей Gemini API и Gemini от злоупотреблений. Чтобы устранить эту ошибку, нужно включить .

2. Отправьте запрос из приложения в Firebase AI Logic ещё раз.

   В этом запросе будет действительный токен App Check, и ошибка 403 - PERMISSION_DENIED больше не появится.

3. Если вы уже применяете правило App Check и все равно получаете это сообщение об ошибке, проверьте, включена ли защита от повторного воспроизведения для Firebase AI Logic (в том числе в режиме "Только мониторинг").

   Если защита от повторного воспроизведения включена, для Firebase AI Logic будут считаться проверенными только токены с ограниченным использованием. Обычные токены сеанса не устраняют эту ошибку. Вы можете включить в приложении токены ограниченного использования или отключить защиту от повторных атак для Firebase AI Logic, отправить запрос повторно и подождать около суток, прежде чем снова включить защиту от повторных атак (активность проекта оценивается ежедневно).

4. Прежде чем выпускать приложение для конечных пользователей, вам нужно настроить поставщика подтверждения для рабочей версии (например, App Attest, Play Integrity или reCAPTCHA Enterprise), чтобы конечные пользователи могли получить доступ к функции ИИ, когда App Check будет включено.

Ошибка 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.

Ошибка 403: Requests to this API firebasevertexai.googleapis.com ... are blocked.

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

Чтобы устранить эту проблему, обновите ограничения для ключа API в консоли Google Cloud, добавив нужный API. Для Firebase AI Logic необходимо убедиться, что Firebase AI Logic API (firebasevertexai.googleapis.com) включен в список выбранных API, которые можно вызывать с помощью ключа API.

Для этого выполните следующие действия:

1. В консоли Google Cloud откройте панель APIs & Services (API и сервисы) > Credentials (Учетные данные).

2. Выберите ключ API, который настроен для использования в вашем приложении (например, "Ключ iOS" для приложения iOS).

3. На странице Edit API key (Изменить ключ API) найдите раздел API restrictions (Ограничения API).

4. Убедитесь, что выбран вариант Restrict key (Задать ограничения для ключа). Если нет, то ваш ключ не ограничен, и, скорее всего, проблема не в нем.

5. В раскрывающемся меню Selected APIs (Выбранные API) найдите и выберите Firebase AI Logic API, чтобы добавить его в список выбранных API, которые можно вызывать с помощью ключа API.

6. Нажмите Сохранить.

   Изменения вступят в силу в течение пяти минут.

Ошибка 404: Firebase AI Logic genai config not found

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

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

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

  Что нужно сделать:
  В консоли Firebase выберите Сервисы ИИ > Логика ИИ. Нажмите Начать и выберите поставщика Gemini API. Включите API, и Firebase настроит ваш проект для этого поставщика. После этого попробуйте выполнить запрос ещё раз.

• Если вы недавно выполнили настройку Firebase AI Logic в консоли Firebase, конфигурация Firebase AI Logic может быть ещё недоступна для всех необходимых внутренних сервисов во всех применимых регионах.

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

Ошибка 404: модель "was not found or your project does not have access to it"?

Пример: "Publisher Model projects/PROJECT-ID/locations/us-central1/publishers/google/models/gemini-3.1-pro-preview was not found or your project does not have access to it. Please ensure you are using a valid model version."

Такая ошибка может возникать по нескольким причинам.

• Недопустимое название модели

  • Причина. Указанное вами название модели недействительно.

  • Решение. Сравните название и версию модели с списком поддерживаемых и доступных моделей. Обязательно проверьте сегменты и их порядок в названии модели. Пример:

    • Название последней модели Gemini 3.x Pro: gemini-3.1-pro-preview (доступно только в предварительной версии)
    • Последняя модель: Gemini 3.x Flash Название модели: gemini-3.8-flash
    • Последняя модель: Gemini 3.x Flash‑Lite Название модели: gemini-3.5-flash-lite
    • Последняя версия Gemini 3.x Pro Image (также известная как Nano Banana Pro) название модели: gemini-3-pro-image
    • Последняя версия Gemini 3.x Flash Image (также известная как "Nano Banana 2") Название модели: gemini-3.1-flash-image
    • Последняя версия Gemini 3.x Flash‑Lite Image (также известная как Nano Banana 2 Lite) Название модели: gemini-3.1-flash-lite-image
    • Последняя версия Gemini 2.5 Flash Image (также известная как "Nano Banana") название модели: gemini-2.5-flash-image

• Недопустимое местоположение (применимо только при использовании поставщика Agent Platform Gemini API (formerly Vertex AI))

  • Причина. Ваш запрос может пытаться получить доступ к модели в регионе, где она недоступна.

  • Решение. Убедитесь, что ваш запрос пытается получить доступ к модели, где она доступна.

    При использовании Agent Platform Gemini API (formerly Vertex AI) можно указать местоположение, чтобы получить доступ к модели во время инициализации. Если вы не укажете местоположение, по умолчанию Firebase AI Logic будет использовать следующие местоположения:

    • При использовании синтаксиса инициализации Agent Platform: global
    • При использовании устаревшего синтаксиса инициализации Vertex AI: us-central1

    Однако не все модели поддерживаются в этих местоположениях по умолчанию. Это означает, что в зависимости от модели может потребоваться явно задать определенное местоположение во время инициализации.

    • Gemini Предварительные и экспериментальные модели доступны только в регионе global.

    • Gemini 3.x Стабильные модели. Доступны в global, а также часто в us и eu.

    • Модели Gemini 2.5: доступны во многих регионах. Обратите внимание, что модели Gemini Live API 2.5 не доступны в global.

  Подробнее о том, как указать местоположение для доступа к модели (в том числе к фрагментам кода)…

Ошибки 429: "You exceeded your current quota, please check your plan and billing details" или "Resource exhausted, please try again later."

Такая ошибка может возникать по нескольким причинам.

• Вы превысили квоту или модель, к которой вы обращаетесь, перегружена запросами от других пользователей.

  Действия зависят от того, используете ли вы Gemini Developer API или Agent Platform Gemini API (formerly Vertex AI). Подробнее о квотах и о том, как запросить их увеличение…

  Если вы используете Agent Platform Gemini API (formerly Vertex AI), в документации по Google Cloud можно найти дополнительную информацию и рекомендации по коду ошибки 429.

• Вы пытаетесь использовать модель или функцию, для которой требуется оплата, но в вашем проекте Firebase действует тарифный план Spark.

  Если вы используете Gemini Developer API, то можете получить ограниченный доступ к некоторым моделям и многим основным функциям в рамках Gemini Developer API бесплатного плана. Этот уровень позволяет начать работу без указания способа оплаты, а значит, вам не нужно переходить на тарифный план Blaze с оплатой по факту использования.

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

    • Большинство предварительных и экспериментальных моделей
    • Модели для создания изображений (модели Nano Banana)

  • Некоторые модели предлагают базовые функции на бесплатном уровне, а для доступа к более продвинутым функциям требуется платный уровень.Gemini Developer API Пример:

    • При использовании большинства моделей Gemini 3.x для обоснования с помощью Google Search или Google Maps требуется оплата.

  Подробнее о тарифных планах Firebase и Gemini Developer API…

  Подробную информацию можно найти в Gemini Developer API документации о ценах и часто задаваемых вопросах об оплате.