Проверьте ключ одной командой
Если ответ 400 API key not valid, дело в ключе. Если FAILED_PRECONDITION, ключ в порядке, дело в регионе.
curl "https://generativelanguage.googleapis.com/v1beta/models" \ -H "x-goog-api-key: $GEMINI_API_KEY"
Gemini API в России: как получить ключ, чем оплатить и что значат ошибки
Ключ Gemini выдаётся в Google AI Studio и привязан к проекту Google Cloud. Из России ломаются оба шага. Разбираем ключи, оплату, регион и три главные ошибки.
/ Короткий ответ
Что это значит
Gemini API — это интерфейс Google к моделям Gemini: ключ создаётся в Google AI Studio, привязывается к проекту Google Cloud и передаётся в запросе заголовком x-goog-api-key или параметром key. Без платёжного профиля в проекте действует бесплатный уровень с низкими лимитами; для продакшена нужна привязанная карта.
Два ограничения для разработчика из России. Первое: с 19 июня 2026 Google отклоняет «неограниченные» стандартные ключи, а с сентября 2026 стандартные ключи не принимаются совсем — нужны auth-ключи, новые создаются сразу в этом формате. Старый ключ из кода отвечает 400 API key not valid, хотя год назад работал. Второе: AI Studio и оплата из России ограничены, коммерческого присутствия Google в стране нет с 2022 года, поэтому российскую карту к проекту не привязать.
Типичные ошибки три: API key not valid (400) — ключ неверный или старого типа; User location is not supported for the API use (400, FAILED_PRECONDITION) — запрос из неподдерживаемого региона; RESOURCE_EXHAUSTED (429) — исчерпан лимит запросов или квота проекта. У Gemini есть OpenAI-совместимый режим, поэтому те же модели доступны и через любой OpenAI-совместимый шлюз без правки кода.
/ Почему
Откуда берётся ошибка
- Ключ старого типа: стандартный ключ, созданный до лета 2026, с сентября отклоняется. Нужно создать auth-ключ в AI Studio.
- Опечатка или чужой ключ: ключ Google Cloud от другого сервиса или ключ с пробелом в переменной окружения. Ответ тот же: API key not valid.
- Регион: запрос с российского IP или проект с российским платёжным профилем. FAILED_PRECONDITION, User location is not supported.
- Квота: бесплатный уровень или лимит проекта исчерпан. RESOURCE_EXHAUSTED с кодом 429, иногда ещё и сообщение о квоте на день.
- Оплата: к проекту не привязана карта, а модель или объём требуют платного уровня. Российскую карту Google не принимает.
/ Таблица
Ошибки Gemini API: текст, причина, что делать
| Текст ошибки | Причина | Что делать |
|---|---|---|
| 400 API key not valid. Please pass a valid API key | Ключ с опечаткой, отозван, от другого сервиса или стандартного типа, который с сентября 2026 не принимается. | Создать новый auth-ключ в AI Studio, проверить переменную окружения, убрать пробелы и кавычки. |
| 400 FAILED_PRECONDITION: User location is not supported for the API use | Регион запроса или платёжного профиля не поддерживается. | Другой ключ не поможет. Нужен адрес API в поддерживаемом регионе или шлюз. |
| 429 RESOURCE_EXHAUSTED | Лимит запросов в минуту или квота проекта исчерпаны. | Повторить через паузу, сократить частоту, привязать оплату для повышения лимита. |
| 403 PERMISSION_DENIED | У проекта или ключа нет доступа к API или модели. | Включить Generative Language API в проекте, проверить ограничения ключа. |
| 404 NOT_FOUND: model not found | Неверное имя модели или версия недоступна в регионе. | Проверить имя в списке моделей, убрать лишние суффиксы. |
Gemini возвращает ошибки в формате Google API: поле status (FAILED_PRECONDITION, RESOURCE_EXHAUSTED) и текстовое message. Ориентируйтесь на status.
/ Что делать
Порядок действий
Пересоздайте ключ как auth-ключ
В AI Studio создайте новый ключ: с сентября 2026 все новые ключи создаются в этом формате. Старые стандартные ключи удалите из кода, они уже не заработают.
Определитесь с регионом до кода
Если запрос идёт с российского IP или проект привязан к российскому профилю, API ответит User location is not supported. Ключ, VPN на минуту или новый проект это не чинят: нужен либо зарубежный аккаунт с картой, либо шлюз.
Используйте OpenAI-совместимый режим
У Gemini есть OpenAI-совместимая точка входа, поэтому код на OpenAI SDK работает с моделями Gemini без переписывания. Меняются base_url и имя модели.
from openai import OpenAI
client = OpenAI(base_url="https://api.kosareva.cloud/v1", api_key="ваш_ключ")
r = client.chat.completions.create(model="gemini-3-8-flash", messages=[{"role": "user", "content": "ping"}])
print(r.choices[0].message.content)Обрабатывайте 429 повторами
RESOURCE_EXHAUSTED на бесплатном уровне приходит быстро. Пауза 1–2 секунды с удвоением, не больше пяти попыток; в SDK это max_retries.
/ По инструментам
Где это чинится в разных инструментах
- Python и Node.js SDK Google. Ключ в GEMINI_API_KEY или GOOGLE_API_KEY; исключение содержит status и message, ловите по status.
- OpenAI SDK, LangChain, LlamaIndex. Через OpenAI-совместимый режим или шлюз: base_url, ключ, имя модели. Ошибки приходят в формате OpenAI.
- Cline, Continue, Open WebUI. Провайдер Gemini с полем ключа или OpenAI Compatible с base URL шлюза и моделью gemini-3-8-flash.
- n8n и Make. Нода Google Gemini принимает ключ AI Studio; если она отвечает FAILED_PRECONDITION, сервер n8n стоит в неподдерживаемом регионе.
/ FAQ
Частые вопросы
Как получить gemini api ключ из России?
Ключ выдаётся в Google AI Studio, а вход туда и привязка карты из России ограничены. Даже с зарубежным аккаунтом запросы с российского IP отвечают User location is not supported.
Почему рабочий ключ вдруг отвечает API key not valid?
Скорее всего это стандартный ключ, созданный до лета 2026: с сентября 2026 Google принимает только auth-ключи. Создайте новый в AI Studio.
Работает ли Gemini API бесплатно?
Есть бесплатный уровень с низкими лимитами по запросам в минуту и в день, для прототипов. При превышении приходит RESOURCE_EXHAUSTED, для продакшена нужна оплата.
/ На kosareva.cloud
Как это выглядит у нас
Модели Gemini у нас доступны через тот же OpenAI-совместимый адрес https://api.kosareva.cloud/v1 под именами gemini-3-8-flash и gemini-3-1-pro: без AI Studio, проекта Google Cloud и зарубежной карты. Gemini 3.8 Flash стоит 81 ₽ за миллион токенов на входе и 405 ₽ на выходе, Gemini 3.1 Pro — 216 и 1296 ₽. Запросы идут с российских IP, оплата в рублях картой или СБП от 50 ₽, юрлицо по счёту; ошибки приходят в формате OpenAI.
/ Дальше
Рядом в справочнике
Ключ, который работает из России
OpenAI-совместимый адрес, оплата в рублях, ключ сразу после регистрации. Пополнение картой от 50 ₽.