На этой странице представлена информация по устранению распространенных ошибок, связанных с API Gemini и SDK Firebase AI Logic .
Если вы получаете ошибку 400 с сообщением API key not valid. Please pass a valid API key. , это обычно означает, что ключ API в вашем файле/объекте конфигурации Firebase не существует или не настроен для использования с вашим приложением и/или проектом Firebase.
Убедитесь, что ключ API, указанный в вашем файле/объекте конфигурации Firebase, совпадает с ключом API вашего приложения. Вы можете просмотреть все свои ключи API на панели «API и сервисы» > «Учетные данные» в консоли Google Cloud .
Если вы обнаружите, что они не совпадают, получите новый конфигурационный файл/объект Firebase и замените им тот, что находится в вашем приложении. Новый конфигурационный файл/объект должен содержать действительный ключ API для вашего приложения и проекта Firebase.
При попытке отправить многомодальный запрос с использованием 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 .
Если вы получаете ошибку 403 с сообщением « Requests to this API firebasevertexai.googleapis.com ... are blocked. , это обычно означает, что ключ API в конфигурации Firebase вашего приложения имеет ограничения, которые препятствуют вызову необходимого API.
Для решения этой проблемы необходимо обновить ограничения вашего API-ключа в консоли Google Cloud , добавив в них требуемый API. Для Firebase AI Logic необходимо убедиться, что API Firebase AI Logic ( firebasevertexai.googleapis.com ) включен в список API, которые можно вызывать с помощью данного API-ключа.
Выполните следующие шаги:
В консоли Google Cloud откройте панель «API и сервисы» > «Учетные данные» .
Выберите ключ API, который настроен для использования вашим приложением (например, «ключ iOS» для приложения iOS).
На странице редактирования ключа API найдите раздел «Ограничения API» .
Убедитесь, что выбран параметр «Ограничить доступ к ключу» . Если он не выбран, ваш ключ не имеет ограничений, и это, вероятно, не является причиной ошибки.
В раскрывающемся меню «Выбранные API» найдите и выберите Firebase AI Logic API , чтобы добавить его в список API, которые можно вызывать с помощью ключа API.
Нажмите « Сохранить ».
Для вступления изменений в силу может потребоваться до пяти минут.
Если вы получаете ошибку 403 с сообщением PERMISSION_DENIED: The caller does not have permission. это обычно означает, что ключ API в вашем файле/объекте конфигурации Firebase принадлежит другому проекту Firebase.
Убедитесь, что ключ API, указанный в вашем файле/объекте конфигурации Firebase, совпадает с ключом API вашего приложения. Вы можете просмотреть все свои ключи API на панели «API и сервисы» > «Учетные данные» в консоли Google Cloud .
Если вы обнаружите, что они не совпадают, получите новый конфигурационный файл/объект Firebase и замените им тот, что находится в вашем приложении. Новый конфигурационный файл/объект должен содержать действительный ключ API для вашего приложения и проекта Firebase.
Если при попытке использовать API разработчика Gemini вы получаете ошибку 404 с сообщением Firebase AI Logic genai config not found , это обычно означает, что в вашем проекте Firebase отсутствует действительный ключ API Gemini для использования с клиентскими SDK Firebase AI Logic .
Вот наиболее вероятные причины этой ошибки:
Вы еще не настроили свой проект Firebase для использования API разработчика Gemini .
Что делать:
В консоли Firebase перейдите в раздел AI Services > AI Logic . Нажмите «Начать» , а затем выберите Gemini Developer API . Включите API, и консоль настроит ваш проект для работы с Gemini Developer API . После завершения процесса повторите запрос.Если вы совсем недавно выполнили процедуру настройки Firebase AI Logic в консоли Firebase , то ваш ключ API Gemini может быть еще недоступен для всех необходимых бэкэнд-сервисов во всех регионах.
Что делать:
Подождите несколько минут, а затем повторите запрос.Возможно, ваш API-ключ Gemini был удален из вашего проекта Firebase.
Что делать:
Узнайте, как изменить ключ API Gemini , используемый Firebase AI Logic .
Например: " Publisher Model projects/PROJECT-ID/locations/us-central1/publishers/google/models/gemini-3-pro-image-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 :
gemini-3.5-flash - Название последней модели Gemini 3.x Flash‑Lite :
gemini-3.1-flash-lite - Последняя версия образа Gemini 3.x Pro (также известная как "Nano Banana Pro"), название модели:
gemini-3-pro-image-preview(доступна только в режиме предварительного просмотра). - Последняя версия образа прошивки Gemini 3.x (также известная как "Nano Banana 2"), название модели:
gemini-3.1-flash-image-preview(доступна только в режиме предварительного просмотра). - Название последней модели «Nano Banana»:
gemini-2.5-flash-image
- Название последней модели Gemini 3.x Pro :
Неверное местоположение (применимо только при использовании API-провайдера Vertex AI Gemini )
Причина : Каждый ваш запрос, использующий API Vertex AI Gemini, должен включать местоположение, откуда вы хотите получить доступ к модели. Ваш запрос может пытаться получить доступ к модели в месте, где она недоступна.
Исправление : Убедитесь, что ваш запрос пытается получить доступ к модели, если она доступна.
При использовании API Vertex AI Gemini , Firebase AI Logic по умолчанию использует
us-central1. Однако не все модели поддерживаются вus-central1. Это означает, что в зависимости от модели вам может потребоваться явно указать конкретное местоположение во время инициализации.Предварительные и экспериментальные модели Gemini : необходимо установить
globalместоположение (за исключением моделей Live API ). Все предварительные и экспериментальные модели Gemini (кроме моделей Live API ) доступны только вglobalместоположении.Для моделей Gemini 3.x : при использовании Firebase AI Logic необходимо установить
globalместоположение. Firebase AI Logic пока не поддерживает местоположенияusиeu.Для моделей Gemini 2.5 : указание местоположения необязательно. Если вы не укажете местоположение, по умолчанию будет использоваться
us-central1.Модели Gemini Live API : указание местоположения необязательно. Если вы не укажете местоположение, по умолчанию будет использоваться
us-central1. Обратите внимание, чтоglobalместоположение не поддерживается.
Узнайте больше о том, как указать место для доступа к модели (включая фрагменты кода).
Ошибка 429 указывает на то, что вы либо превышаете свою квоту, либо модель, к которой вы обращаетесь, перегружена запросами от других пользователей.
Действия, которые необходимо предпринять, зависят от того, используете ли вы API разработчика Gemini или API Vertex AI Gemini . Для получения дополнительной информации о квотах и о том, как запросить дополнительные квоты, см. раздел «Ограничения скорости и квоты» .
Если вы используете API Vertex AI Gemini , в документации Google Cloud вы найдете дополнительную информацию и рекомендации по устранению ошибки с кодом 429 .