На этой странице представлена информация по устранению распространенных ошибок, связанных с 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 перейдите на страницу Firebase 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.1 Pro —
gemini-3.1-pro-preview. - Название модели Gemini 3 Flash Preview —
gemini-3-flash-preview. - Предварительное название модели "Nano Banana Pro" —
gemini-3-pro-image-preview. - Предварительное название модели "Nano Banana 2" —
gemini-3.1-flash-image-preview. - Модель "Nano Banana" называется
gemini-2.5-flash-image.
- Название предварительной версии Gemini 3.1 Pro —
Неверное местоположение (применимо только при использовании API-провайдера Vertex AI Gemini и предварительной или экспериментальной модели)
Причина : Вы используете предварительную или экспериментальную версию модели (например,
gemini-3.1-pro-previewиgemini-3.1-flash-image-preview) и не указалиglobalместоположение.При использовании API Vertex AI Gemini все предварительные и экспериментальные модели Gemini (кроме моделей Gemini Live) доступны только в
globalрасположении. Однако, поскольку Firebase AI Logic по умолчанию использует это расположение,При использовании этих предварительных и экспериментальных моделей Gemini вам необходимо явно указать us-central1местоположение при инициализации бэкэндglobalсервиса API Vertex AI Gemini в вашем коде.Исправление : При инициализации сервиса Vertex AI Gemini API укажите
globalместоположение. Подробнее о том, как указать местоположение для доступа к модели (включая фрагменты кода), можно узнать здесь.
Неверное местоположение (применимо только при использовании API-провайдера Vertex AI Gemini )
Причина : Вы используете модель, которая не поддерживается в том месте, где вы пытаетесь получить к ней доступ.
При использовании API Vertex AI Gemini некоторые модели доступны только в определенных регионах . Например (список не является исчерпывающим):
- В
globalконфигурации модели изображений не поддерживаются. - Модели Gemini Live API (например,
gemini-2.0-flash-live-preview-04-09) поддерживаются только вМестоположение us-central1. - Модели Gemini 2.5 (например,
gemini-2.5-pro) доступны только в странахglobal, в США и некоторых странах Европы (а иногда и в других странах, если ваш проект предполагает наличие специальных опций).
- В
Исправление : При инициализации сервиса Vertex AI Gemini API убедитесь, что вы указали поддерживаемое местоположение для используемой модели. Подробнее о том, как указать местоположение для доступа к модели (включая фрагменты кода) и поддерживаемые местоположения для моделей , можно узнать здесь.
Обратите внимание, что Firebase AI Logic по умолчанию использует следующий подход:
Местоположение us-central1.
Ошибка 429 указывает на то, что вы либо превышаете свою квоту, либо модель, к которой вы обращаетесь, перегружена запросами от других пользователей.
Действия, которые необходимо предпринять, зависят от того, используете ли вы API разработчика Gemini или API Vertex AI Gemini . Для получения дополнительной информации о квотах и о том, как запросить дополнительные квоты, см. раздел «Ограничения скорости и квоты» .
Если вы используете API Vertex AI Gemini , в документации Google Cloud вы найдете дополнительную информацию и рекомендации по устранению ошибки с кодом 429 .