# Ключ Google AI Studio: проверка региона, создание и первый запрос

> Сам API-ключ Gemini бесплатный. На 8 октября 2026 года без оплаты работают модели Flash и Gemini 2.5 Pro, а картинки и 3.1 Pro Preview требуют оплаты.

- URL: https://blog.laozhang.ai/ru/posts/google-ai-studio-api-key
- Published: 2026-08-29
- Updated: 2026-10-08
- Author: LaoZhang AI Team (https://blog.laozhang.ai/ru/about)
- Topic: Руководства по API
- Tags: Google AI Studio, Gemini API, API ключ, Google Cloud, Безопасность API

---
Ключ Google AI Studio — это API-ключ, которым запросы к Gemini Developer API подтверждают, от какого Google Cloud-проекта они приходят. Получить его можно на [странице API-ключей в Google AI Studio](https://aistudio.google.com/apikey), и сам ключ ничего не стоит. Расходы возникают только тогда, когда проект с подключённой оплатой обращается к платной модели. Ключ не заменяет подписку Gemini и не даёт отдельного запаса запросов: лимиты считаются на весь проект.

Данные ниже приведены по состоянию на 8 октября 2026 года. С 28 мая 2026 года AI Studio создаёт только ключи авторизации (authorization keys), Gemini API отклоняет запросы со стандартных ключей без ограничений, а бесплатными остаются модели Flash, Gemini 2.5 Pro и голосовые модели, но не генерация изображений.

Для русскоязычного пользователя есть обязательный шаг до регистрации. На 8 октября 2026 года в [официальном списке регионов Google AI Studio и Gemini API](https://ai.google.dev/gemini-api/docs/available-regions) России нет. Там же указаны возраст 18+ и возможная проверка возраста. Если ваше фактическое использование не соответствует текущим условиям, подключение к прямому Developer API следует отложить. Чужой аккаунт, фиктивный адрес, VPN или купленный «Google key» не превращают неподходящий аккаунт в допустимый.

Дальнейшие действия относятся только к пользователю, который реально находится в поддерживаемом регионе и выполняет требования аккаунта, организации и применимых условий.

## Бесплатный ли API-ключ Gemini и какие модели работают без оплаты

Ключ бесплатный в любом случае. Платить или нет, определяют уровень проекта и выбранная модель. Новый проект начинает с бесплатного уровня (Free), и на нём, согласно [официальной странице цен Gemini API](https://ai.google.dev/gemini-api/docs/pricing), на 8 октября 2026 года доступны такие модели:

| Группа | Работает на бесплатном уровне | Только после подключения оплаты |
|---|---|---|
| Текстовые модели Gemini | Gemini 3.8 Flash, 3.7 Flash, 3.6 Flash, 3.5 Flash, 3.5 Flash-Lite, 3.1 Flash-Lite, 3 Flash Preview, 2.5 Pro, 2.5 Flash, 2.5 Flash-Lite | Gemini 3.1 Pro Preview, Gemini Omni Flash |
| Изображения | нет ни одной модели | Nano Banana 2.1, Nano Banana 2, Nano Banana 2 Lite, Nano Banana Pro, Gemini 2.5 Flash Image |
| Голос и Live | Gemini 3.8 Live, Live Translate, Transcribe, 3.8 Flash TTS, 3.8 Flash-Lite TTS, 3.1 Flash TTS Preview, 2.5 Flash Preview TTS, 2.5 Flash Native Audio | Gemini 2.5 Pro Preview TTS |
| Открытые модели | Gemma 4 (платного уровня у неё нет) | — |
| Режимы и инструменты | — | Batch, Flex, ответы с опорой на Google Поиск и Google Maps (grounding) |

Отсюда и ответ про Gemini 2.5 Flash: обычный бесплатный ключ с ней работает, оплата для неё не нужна. А вот картинки через API бесплатно не получить ни в одной модели; подробности и цены собраны в материале «[Gemini Image API бесплатно? Нет: картинки от $0,0336 за штуку](https://blog.laozhang.ai/ru/posts/gemini-image-api-free)».

У бесплатного уровня есть два условия, которые стоит знать заранее. Во-первых, по таблице цен данные запросов на бесплатном уровне используются для улучшения продуктов Google, на платном — нет. Во-вторых, общей таблицы лимитов в документации нет: актуальные значения для вашего проекта показывает [страница лимитов в AI Studio](https://aistudio.google.com/rate-limit). Несколько ключей одного проекта делят один лимит.

Платный доступ включается не покупкой ключа, а привязкой платёжного аккаунта к проекту в AI Studio. По [документации о лимитах Gemini API](https://ai.google.dev/gemini-api/docs/rate-limits) проект после этого переходит на Tier 1, обычно сразу. У Tier 1 месячный потолок расходов $250 и ограничение $10 за 10 минут. Для ориентира: Gemini 3.7 Flash на платном уровне стоит $0,75 за 1 млн входных токенов и $3,75 за 1 млн выходных до 31 декабря 2026 года, а с 1 января 2027 года — $1,50 и $7,50.

Поэтому предложение «купить ключ Gemini API» означает получить ключ из чужого проекта. Его владелец видит ваши запросы, управляет лимитами и может отозвать ключ в любой момент, а для неподдерживаемого региона такая покупка ничего не меняет в условиях Google.

## Что должно принадлежать вам

Откройте [страницу API-ключей в Google AI Studio](https://aistudio.google.com/apikey) под аккаунтом, который должен управлять интеграцией. Для личного прототипа это может быть личный проект. Для команды заранее определите владельца проекта, администратора IAM, плательщика и ответственного за ротацию.

Согласно [документации по ключам Gemini API](https://ai.google.dev/gemini-api/docs/api-key), каждый ключ принадлежит Google Cloud-проекту. Новому пользователю AI Studio после принятия условий создаёт проект и ключ по умолчанию. Если у аккаунта уже есть Cloud-проекты, проект по умолчанию может не появиться: нужный проект импортируется через **Dashboard → Projects**, после чего ключ создаётся на странице API Keys.

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

Если кнопка создания недоступна, сохраните точный текст сообщения и проверьте выбранный проект. Для создания текущего ключа Google перечисляет разрешения на чтение проекта, создание ключа, включение сервиса, создание сервисного аккаунта и привязку ключа. Запрашивайте у администратора только необходимую роль; не используйте чужой ключ как замену IAM.

## Чем ключ авторизации отличается от старого стандартного ключа

С 28 мая 2026 года все новые ключи в Google AI Studio автоматически создаются как ключи авторизации (auth keys). Такой ключ связан с сервисным аккаунтом и по умолчанию ограничен только Gemini API, поэтому его нельзя случайно использовать для других сервисов Google Cloud. Тип каждой записи виден в столбце **Key Type** на странице ключей.

Старые стандартные ключи (standard keys) делятся на два случая. Если у ключа нет ограничений, Gemini API отклоняет запросы с него. Стандартный ключ с явно заданными ограничениями по документации на 8 октября 2026 года продолжает работать. Если старый ключ отмечен как standard без ограничений или как blocked, не пытайтесь его «оживить»: создайте ключ авторизации в контролируемом проекте, замените секрет в хранилище и удалите старую запись.

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

![Сравнение ключа авторизации и стандартных ключей с ограничениями и без них; порядок замены отклоняемого ключа](https://blog.laozhang.ai/posts/ru/google-ai-studio-api-key/img/key-types.webp)

## Сохраните ключ, не показывая его

Ключ даёт доступ к лимитам проекта и при включённой оплате может создавать расходы. Его нельзя размещать:

- в Git и истории коммитов;
- в клиентском JavaScript, мобильном приложении или публичном расширении;
- в отчёте об ошибке, полном дампе окружения, скриншоте и записи терминала;
- в URL, который попадёт в логи и аналитику.

Для локального окружения Google SDK распознаёт `GEMINI_API_KEY` и `GOOGLE_API_KEY`. Если установлены обе переменные, приоритет имеет `GOOGLE_API_KEY`.

```bash
export GEMINI_API_KEY="YOUR_API_KEY"
```

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

```bash
test -n "${GEMINI_API_KEY:-}" \
  && echo "GEMINI_API_KEY задан" \
  || echo "GEMINI_API_KEY отсутствует"
```

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

## Выполните один проверочный запрос

[Быстрый старт Gemini API](https://ai.google.dev/gemini-api/docs/get-started) использует Interactions API, а секрет передаётся в заголовке. Для проверки ниже взята модель `gemini-3.7-flash`: на 8 октября 2026 года она входит в бесплатный уровень, так что запрос не требует оплаты.

```bash
curl -sS -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.7-flash",
    "input": "Коротко подтвердите, что API-соединение работает."
  }'
```

Успешный результат — структурированный ответ Interactions API со статусом завершения и содержимым ответа. Конкретная фраза модели не важна. Важно, что запрос ушёл на ожидаемый сервер, аутентифицировался нужным ключом и вернулся с успешным состоянием.

Ключ не привязан к одной модели: тот же ключ подходит для Gemini 2.5 Flash и остальных моделей из таблицы выше. Для первой проверки берите модель из колонки бесплатного уровня. Модель для картинок или Gemini 3.1 Pro Preview в проекте без оплаты ответит отказом, даже если с ключом всё в порядке.

Модели и интерфейсы API меняются. Если текущий официальный пример использует другое имя, обновите проверочный запрос по документации, а не подбирайте идентификатор наугад.

## Как читать ошибку, не перебирая ключи

Сохраните HTTP-статус, обезличенное тело ответа, идентификатор проекта, адрес API, модель, время UTC и идентификатор запроса. Полный ключ не сохраняйте. Затем меняйте только один параметр.

| Наблюдение | Что проверять первым | Следующее действие |
|---|---|---|
| AI Studio не открывает управление ключами | Регион, возраст, проверку аккаунта и его ограничения | Сверить официальный список; отложить прямое подключение, если условия не выполнены |
| Нельзя создать ключ | Импорт проекта и права IAM | Проверить идентификатор проекта и требуемые разрешения |
| Старый ключ перестал работать | Тип в столбце Key Type: стандартный без ограничений или blocked | Создать ключ авторизации и заменить секрет, а не повторять запрос |
| `403 PERMISSION_DENIED` | Активный ключ, проект, ограничения ключа и операцию | Использовать [пошаговую диагностику 403](https://blog.laozhang.ai/ru/posts/gemini-api-key-permission-denied) |
| `429 RESOURCE_EXHAUSTED` | Текущие лимиты проекта, модели и уровня | Открыть AI Studio и [руководство по лимитам](https://blog.laozhang.ai/ru/posts/gemini-api-rate-limits-guide) |
| Отказ у модели для картинок или Gemini 3.1 Pro Preview | Уровень проекта: у этих моделей нет бесплатного уровня | Подключить оплату или выбрать бесплатную модель; для картинок — [разбор ошибки 429 Gemini при генерации изображений](https://blog.laozhang.ai/ru/posts/gemini-image-429-rate-limit) |
| Model/route not found | Текущий идентификатор модели и версия API | Повторить официальный пример один раз |
| Временная ошибка сервера | Состояние сервиса и правила повторных попыток | Ограниченные повторы с увеличением задержки, без создания нового ключа |

Успешный пробный запрос не подтверждает пропускную способность под рабочей нагрузкой. Бесплатный уровень распространяется только на часть моделей и режимов, а фактические лимиты видны в AI Studio для конкретного проекта. Несколько ключей одного проекта не создают несколько независимых пулов квоты.

![Направления диагностики ошибок 403, 429, неверного маршрута или модели и временной ошибки сервера; общий лимит проекта и границы пробного запроса](https://blog.laozhang.ai/posts/ru/google-ai-studio-api-key/img/error-diagnosis.webp)

Решение о переходе с бесплатного уровня на Tier 1 и о стоимости принимайте после успешной проверки. Для этого используйте [отдельный разбор цены и маршрутов Gemini API](https://blog.laozhang.ai/ru/posts/gemini-api-pricing) и актуальную [официальную страницу цен](https://ai.google.dev/gemini-api/docs/pricing). Перед запуском приложения запишите идентификатор и владельца проекта, тип ключа, место его хранения и порядок замены, разрешённый сервер, модель, текущие лимиты и состояние оплаты.

## Источники

Внешние страницы, на которые ссылается это руководство, в порядке упоминания. Последнее обновление: 2026-10-08.

- [странице API-ключей в Google AI Studio](https://aistudio.google.com/apikey) (aistudio.google.com)
- [официальном списке регионов Google AI Studio и Gemini API](https://ai.google.dev/gemini-api/docs/available-regions) (ai.google.dev)
- [официальной странице цен Gemini API](https://ai.google.dev/gemini-api/docs/pricing) (ai.google.dev)
- [страница лимитов в AI Studio](https://aistudio.google.com/rate-limit) (aistudio.google.com)
- [документации о лимитах Gemini API](https://ai.google.dev/gemini-api/docs/rate-limits) (ai.google.dev)
- [документации по ключам Gemini API](https://ai.google.dev/gemini-api/docs/api-key) (ai.google.dev)
- [Быстрый старт Gemini API](https://ai.google.dev/gemini-api/docs/get-started) (ai.google.dev)