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

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

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

Для русскоязычного пользователя есть обязательный шаг до регистрации. На 8 октября 2026 года в официальном списке регионов Google AI Studio и Gemini API России нет. Там же указаны возраст 18+ и возможная проверка возраста. Если ваше фактическое использование не соответствует текущим условиям, подключение к прямому Developer API следует отложить. Чужой аккаунт, фиктивный адрес, VPN или купленный «Google key» не превращают неподходящий аккаунт в допустимый.

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

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

Ключ бесплатный в любом случае. Платить или нет, определяют уровень проекта и выбранная модель. Новый проект начинает с бесплатного уровня (Free), и на нём, согласно официальной странице цен Gemini API, на 8 октября 2026 года доступны такие модели:

Отсюда и ответ про Gemini 2.5 Flash: обычный бесплатный ключ с ней работает, оплата для неё не нужна. А вот картинки через API бесплатно не получить ни в одной модели; подробности и цены собраны в материале «Gemini Image API бесплатно? Нет: картинки от $0,0336 за штуку».

У бесплатного уровня есть два условия, которые стоит знать заранее. Во-первых, по таблице цен данные запросов на бесплатном уровне используются для улучшения продуктов Google, на платном — нет. Во-вторых, общей таблицы лимитов в документации нет: актуальные значения для вашего проекта показывает страница лимитов в AI Studio. Несколько ключей одного проекта делят один лимит.

Платный доступ включается не покупкой ключа, а привязкой платёжного аккаунта к проекту в AI Studio. По документации о лимитах Gemini API проект после этого переходит на 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 под аккаунтом, который должен управлять интеграцией. Для личного прототипа это может быть личный проект. Для команды заранее определите владельца проекта, администратора IAM, плательщика и ответственного за ротацию.

Согласно документации по ключам Gemini API, каждый ключ принадлежит 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, не пытайтесь его «оживить»: создайте ключ авторизации в контролируемом проекте, замените секрет в хранилище и удалите старую запись.

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

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

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

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

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

export GEMINI_API_KEY="YOUR_API_KEY"

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

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

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

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

Быстрый старт Gemini API использует Interactions API, а секрет передаётся в заголовке. Для проверки ниже взята модель gemini-3.7-flash: на 8 октября 2026 года она входит в бесплатный уровень, так что запрос не требует оплаты.

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 для конкретного проекта. Несколько ключей одного проекта не создают несколько независимых пулов квоты.

Решение о переходе с бесплатного уровня на Tier 1 и о стоимости принимайте после успешной проверки. Для этого используйте отдельный разбор цены и маршрутов Gemini API и актуальную официальную страницу цен. Перед запуском приложения запишите идентификатор и владельца проекта, тип ключа, место его хранения и порядок замены, разрешённый сервер, модель, текущие лимиты и состояние оплаты.