При Permission denied («доступ запрещён») не начинайте с покупки тарифа и массового создания ключей.
Сначала установите, какой ключ реально использует приложение, к какому проекту он относится и на каком действии возникает отказ: создание ключа, чтение файла или запрос модели.
Ошибки 403 и 503 разбирайте отдельно: ограничения доступа и недоступность сервиса не обязаны иметь общую причину.
Проверьте ключ и проект
- Сверьте выбранный проект в AI Studio с проектом ключа. Каждый ключ Gemini связан с проектом Google Cloud.
- Проверьте источник секрета в реально запущенном процессе. Если одновременно заданы GOOGLE_API_KEY и GEMINI_API_KEY, клиентские библиотеки отдают приоритет GOOGLE_API_KEY. Обновлённая переменная в редакторе ещё не доказывает, что сервер получил новый ключ.
- Посмотрите тип ключа и его ограничения. По текущей документации Gemini отклоняет unrestricted standard keys, то есть стандартные ключи без ограничений. Новые ключи AI Studio создаёт как authorization keys: они связаны с сервисным аккаунтом, учётной записью приложения.
Ограничение API и источника запроса — разные настройки. Проверьте, разрешён ли Gemini API и подходит ли IP сервера под Application restrictions, ограничения приложения. Не снимайте защиту целиком ради диагностики.
Если отказ связан с правами
Если не работает именно Create API key, проверьте IAM, систему управления правами Google Cloud, а не промпт. Для создания современного ключа нужны, среди прочего, права создания ключа, сервисного аккаунта и привязки ключа к нему.
Попросите администратора проверить требуемые разрешения, вместо выдачи всем роли Owner.
Google отдельно перечисляет возрастные и региональные требования, проверки аккаунта или проекта, принятие условий и ограничения безопасности. Исправный ключ не отменяет эти проверки.
Сравните прямой запрос с интеграцией
Для отчёта об ошибке запишите точный HTTP-код, message, время, название модели и действие. Секрет самого ключа удалите.
Сравните один минимальный запрос из той же среды с вызовом через проблемную интеграцию. Если первый проходит, ищите различия в заголовках, адресе API (endpoint) и загрузке переменных; если нет, проверяйте доступ проекта.
Проверено 10 ноября 2026 года по документации. Собственные тесты API не проводились.
Последнее редактирование: