Ошибка FAILED_PRECONDITION в Gemini API: причины и что делать

hljs jsonКопировать
{
  "error": {
    "code": 400,
    "message": "User location is not supported for the API use.",
    "status": "FAILED_PRECONDITION"
  }
}

Такой ответ Gemini API возвращает, когда запрос приходит из страны или региона, где Google не предоставляет Gemini API и Google AI Studio, либо когда у аккаунта или проекта не выполнено обязательное условие, например не подключена оплата. По состоянию на 30 сентября 2026 года России в списке доступных регионов нет, поэтому из России эта ошибка ожидаема и настройками кода не исправляется. Если же вы работаете из страны, которая в списке есть, ищите причину в биллинге проекта, в подтверждении возраста или в том, где на самом деле выполняется ваш код.

User location is not supported for the API use: что означает ответ

FAILED_PRECONDITION — это статус ошибки 400, которым Gemini API сообщает, что запрос составлен правильно, но не выполнено предварительное условие для его обработки. В справочнике ошибок Google (обновлён 20 сентября 2026 года) этот статус описан так: «The request cannot be processed because a prerequisite is not met (for example, disabled billing)», а рекомендация звучит как «Verify project billing status or account prerequisites». Текст «User location is not supported» уточняет, какое именно условие не выполнено: местоположение, с которым связан запрос или аккаунт.

Повторять запрос бессмысленно: ответ не изменится, пока не устранена причина. Ниже пять ситуаций, в которых встречается эта ошибка.

Россия и другие страны вне списка доступных регионов

Если вы находитесь в России, Gemini API и Google AI Studio для вас недоступны: по состоянию на 30 сентября 2026 года Россия не входит в список стран, где Google их предоставляет (сам список обновлён 28 апреля 2026 года). Беларуси в этом списке тоже нет, как и материкового Китая и Гонконга. В этом случае ошибка работает именно так, как задумано, и никакая правка ключа, SDK или параметров запроса её не уберёт.

Для тех, кто находится вне списка, Google на той же странице предлагает один вариант: Gemini API в Gemini Enterprise Agent Platform — это облачная платформа Google со своим договором и своими правилами доступности. Прежде чем на неё рассчитывать, проверьте, доступна ли она вашей организации в вашей стране.

Подмена местоположения или указание в аккаунте чужих данных — это обход ограничения, а не исправление ошибки. Сверяйтесь с условиями Google о том, где находитесь вы и ваши пользователи.

Биллинг и условия проекта

Если вы работаете из страны, которая есть в списке, первым делом проверьте проект, к которому привязан ключ. Справочник ошибок Google приводит отключённую оплату как пример невыполненного условия для FAILED_PRECONDITION, а на Stack Overflow в 2024 году встречался вариант сообщения, где причина названа прямо: «User location is not supported for the API use without a billing account linked».

По странице о биллинге бесплатный и платный уровни доступны во многих регионах, включая ЕЭЗ, Великобританию и Швейцарию; перейти на платный уровень можно кнопкой «Set up billing» в AI Studio, минимальное предварительное пополнение — $5 (по состоянию на 30 сентября 2026 года). Подключение оплаты выполняет условие биллинга, но не добавляет вашу страну в список доступных регионов.

Оплата включается для проекта, а не для отдельного ключа, и лимиты Gemini API тоже считаются на проект. Поэтому, если ошибка возникает только с одним ключом, сравните, к каким проектам привязаны работающий и неработающий ключи. В ветке справочного форума Google от 16 февраля 2026 года пользователь описывал именно такую картину: новый ключ получал 400, а старый продолжал работать.

Возраст и подтверждение аккаунта Google

Страница AI Studio о доступных регионах называет три причины, по которым пользователь может на неё попасть: сервис недоступен в регионе, пользователь младше 18 лет или возраст в аккаунте Google ещё не подтверждён («You may have access to the service, but you haven't yet verified your age on your Google Account»). Третий случай легко спутать с региональным ограничением: страна поддерживается, а доступа всё равно нет.

Если AI Studio показывает эту страницу, откройте настройки аккаунта Google и проверьте дату рождения и подтверждение возраста, а затем войдите в AI Studio заново.

Сервер, облачная функция или CI в другом регионе

Google оценивает местоположение, связанное с запросом, а запрос отправляет тот компьютер, на котором выполняется код. Если скрипт на вашем ноутбуке работает, а тот же код в облачной функции, контейнере или задаче CI получает FAILED_PRECONDITION, проверьте, в каком регионе развёрнут этот сервис: регион указан в настройках хостинга или в параметрах развёртывания.

Решение для такого случая — развернуть серверную часть, которая обращается к Gemini API, в поддерживаемом регионе. Это обычный выбор хостинга для сервиса, который вам разрешено запускать, а не способ скрыть, откуда вы работаете. Если вы сами или ваши пользователи находитесь в стране вне списка, перенос сервера не меняет того, что говорят условия Google.

Gemini CLI, Antigravity и сторонние приложения

В Gemini CLI та же ошибка выглядит как строка в верхнем регистре: «[API ERROR: USER LOCATION IS NOT SUPPORTED FOR THE API USE. (STATUS: FAILED_PRECONDITION)]» (так она приведена в issue #1993 репозитория gemini-cli от 26 июня 2025 года). На форуме разработчиков Google 21 апреля 2026 года о ней сообщали пользователи Antigravity на macOS. Смысл у всех вариантов один, и проверять нужно те же пункты из таблицы выше.

В сторонних сервисах автоматизации и чат-приложениях запрос к Google часто отправляет не ваш компьютер, а сервер самого сервиса. Тогда значение имеет регион его инфраструктуры и ваш аккаунт у него; точно ответить, откуда уходит запрос, может только поставщик приложения.

Бывает и так, что ошибка появляется внезапно: на форуме Google 26 июня 2026 года пользователь писал, что сеть и IP-адрес не менял, а запросы перестали проходить. Это единичные сообщения без официального объяснения, но они подсказывают, что при «вдруг сломалось» стоит пройти весь чек-лист ниже, а не только перепроверять ключ.

Как прочитать полный ответ ошибки

SDK и приложения часто показывают только часть ответа, например «400 Bad Request». Чтобы увидеть полный текст, отправьте минимальный запрос напрямую:

hljs bashКопировать
curl -i "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{"contents":[{"parts":[{"text":"ping"}]}]}'

Флаг -i выводит HTTP-статус и заголовки, а тело ответа содержит поля code, status и message. Если там FAILED_PRECONDITION и «User location is not supported», дело в регионе или условиях аккаунта; если другой статус, это уже другая ошибка.

В Python с библиотекой google-genai те же поля доступны у исключения:

hljs pythonКопировать
from google import genai
from google.genai import errors

client = genai.Client()  # ключ берётся из GEMINI_API_KEY

try:
    client.models.generate_content(model="gemini-2.5-flash", contents="ping")
except errors.APIError as e:
    print(e.code, e.status, e.message)

Запустите этот тест в той же среде, где работает ваш код: на сервере, в контейнере, в CI. Проверка с ноутбука ничего не скажет о том, что видит Google, когда запрос приходит из облака.

Это не ошибка квоты: чем 400 отличается от 403 и 429

FAILED_PRECONDITION не связан с лимитами запросов, поэтому ожидание, повторные попытки и экспоненциальная задержка здесь не помогают. Рядом с ним часто встречаются две похожие ошибки, и у каждой своё решение (по справочнику ошибок Google на 30 сентября 2026 года):

Если у вас 403, разберитесь с ключом и проектом: об этом отдельная статья — Failed to create interaction: permission denied в AI Studio. Если 429, смотрите лимиты своего уровня в материале «Бесплатные лимиты Gemini API: модели, квоты и ошибка 429».

Что проверить перед обращением в поддержку

1. Где вы находитесь и есть ли эта страна на странице «Available regions». Если нет, как в случае с Россией, обращение в поддержку ничего не изменит.
2. Подтверждены ли в аккаунте Google возраст 18+ и дата рождения.
3. Включена ли оплата в проекте, к которому привязан ключ.
4. Воспроизводится ли ошибка с другим ключом из другого проекта того же аккаунта.
5. Где выполняется код: регион сервера, облачной функции или CI; для сторонних приложений — чей сервер отправляет запрос.
6. Полный текст ответа (code, status, message), время запроса, название модели и версия SDK или Gemini CLI.

С этим набором данных вопрос на форуме разработчиков Google или в поддержке можно разобрать по существу, а не начинать с просьбы прислать подробности.

Частые вопросы

Поможет ли создать новый API-ключ?

Только если проблема в конкретном проекте, например в его биллинге. Ограничение по региону и возрасту относится к вам и вашему аккаунту, поэтому новый ключ в том же аккаунте его не снимет. Бывает и обратное: по сообщению на справочном форуме Google от 16 февраля 2026 года, новый ключ получал ошибку, а старый работал.

Снимет ли подключение оплаты ограничение по региону?

Нет. Оплата выполняет условие биллинга, из-за которого тоже возникает FAILED_PRECONDITION, но страна, которой нет в списке доступных регионов, от этого в него не попадает.

Почему ошибка появилась, хотя я ничего не менял?

Проверьте, не изменились ли регион сервера, проект ключа, статус оплаты и подтверждение возраста. Если всё на месте, соберите данные из чек-листа выше и сообщите о проблеме на форуме разработчиков Google: такие случаи описаны, но официального объяснения у них нет.