Google AI Studio: бесплатный API-ключ к Gemini за 5 шагов

Чем консоль отличается от чата

Разница одна: в чате Gemini с моделью общается человек, а в AI Studio к ней обращается программа по ключу доступа. Чат живёт на gemini.google.com, консоль - на aistudio.google.com. В чате вы задаёте вопрос и читаете ответ глазами. В консоли вы собираете запрос из полей, а ответ забирает ваша программа в том виде, который вы задали заранее - например, строкой JSON с определёнными полями.

Как получить ключ

Куда положить ключ, чтобы он не утёк

Ключ кладут в переменную окружения, а не в код программы и не в репозиторий:

export GEMINI_API_KEY="сюда_вставь_свой_ключ"

# проверить, что переменная заполнена, не показывая сам ключ
echo ${#GEMINI_API_KEY}

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

Первый запрос одной командой

curl -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.6-flash",
    "input": "Explain how AI works in a few words"
  }'

В команде используется имя переменной $GEMINI_API_KEY, а не сам ключ - так он не попадает ни в историю терминала, ни в скриншот. Разница между двумя частыми ошибками - диагностический приём: код 403 означает, что заголовок с ключом до сервера не доехал вообще (переменная пустая или опечатка), код 400 с текстом об ошибке ключа - что заголовок доехал, но строка внутри неверная.

Где заканчивается бесплатный уровень

Таблица прокручивается вбок на телефоне →

Бесплатный уровень измеряется тремя величинами: запросы в минуту, входные токены в минуту и запросы в сутки. Общей таблицы с точными цифрами Google больше не публикует - свои лимиты видно в разделе rate-limit личного кабинета. Изображения (модели Nano Banana) и видео (Veo) через API на бесплатном уровне недоступны - посмотреть их можно прямо в консоли, но вызывать бесплатным ключом из своей программы нельзя.

Актуальный адрес страницы лимитов - ai.google.dev/gemini-api/docs/rate-limits, а не раздел rate-limit в самой консоли. Текстовые модели после исчерпания бесплатного лимита переходят на платный тариф: для Gemini 3.7 Flash по официальному прайсу это 0,75 доллара за миллион входных токенов и 3,75 доллара за миллион выходных до 31 декабря 2026 года, а с 1 января 2027 года цена удваивается - 1,50 и 7,50 доллара за миллион токенов соответственно.

Честная цена нуля рублей

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

Три ошибки, на которые упирается новичок

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