Google AI Studio: что это и как с ним работать

Если вы искали, с чего начать работу с моделями Gemini, вас почти наверняка привели в Google AI Studio. Это веб-консоль, где модели можно потрогать руками: написать промпт, покрутить параметры, посмотреть ответ — а потом одной кнопкой получить готовый код и забрать его в свой проект. Разберём, что внутри, чем AI Studio отличается от чата Gemini и от корпоративной платформы Google Cloud, что там реально бесплатно и за что вы платите на самом деле, а ещё — почему из России оно открывается далеко не у всех.

Что такое Google AI Studio и чем он не является

Вокруг Gemini у Google три разных продукта, и их постоянно путают:

• Gemini (приложение и gemini.google.com) — чат для конечного пользователя: ни кода, ни API, просто диалог.
• Google AI Studio (aistudio.google.com) — среда разработчика: прототип промпта, настройка поведения модели, тесты инструментов и получение API-ключа. Точка входа для одиночек и небольших команд.
• Vertex AI / Gemini Enterprise Agent Platform — те же модели в контуре Google Cloud: IAM-права, выбор региона, SLA, договоры. Сюда переезжают, когда проект вырастает из «ключа в переменной окружения».

Ценность AI Studio в том, что каждый эксперимент в интерфейсе один в один воспроизводится кодом: подобрали формулировку в браузере — она так же работает из вашего бэкенда, потому что под капотом тот же Gemini API.

Что внутри: разделы интерфейса

Chat — основная песочница

Главный экран: слева история диалога, справа панель Run settings — модель, температура и другие параметры генерации, настройки безопасности и переключатели возможностей: структурированный вывод, вызов функций, исполнение кода, grounding (подмешивание результатов поиска в ответ).

Отдельным полем задаётся системная инструкция — постоянные правила поверх любого пользовательского сообщения. Это самое полезное поле на экране; если не работали с ним, начните с заметки «Системный промпт: как задать модели роль и правила».

Тумблер структурированного вывода заставляет модель отвечать валидным JSON по заданной схеме — как это устроено у трёх основных провайдеров, разбирали в заметке «Структурированный вывод (JSON) от модели». Соседний тумблер, вызов функций, позволяет модели дёргать ваши инструменты — механика описана в материале «Tool calling: как ИИ вызывает инструменты».

Потоковые и медийные режимы

Кроме чата есть режим реального времени — двусторонний поток аудио и видео с моделью — и раздел генерации медиа: изображения серии Nano Banana, видео (Veo, Gemini Omni Flash), музыка Lyria. Всё это доступно и через API, интерфейс здесь просто витрина.

Build — режим сборки приложений

Вы описываете приложение словами, AI Studio генерирует его целиком и показывает в живом превью. На Google I/O 19 мая 2026 года режим заметно расширили:

• Android-приложения прямо в браузере. От промпта до нативного приложения на Kotlin и Jetpack Compose, с эмулятором в браузере, поддержкой ADB и публикацией во внутренний тестовый трек Google Play.
• Доступ к Google Workspace из собираемых приложений: дашборд по данным из Таблиц, разбор содержимого Диска.
• Экспорт в Antigravity — проект вместе с историей переписки и файлами уезжает в локальную среду разработки, если приложение переросло браузерную песочницу.
• Правки прямо в превью и генерация картинок для интерфейса через Nano Banana.
• Бесплатный деплой первых двух приложений в Google Cloud, без привязки карты.

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

Какие модели выбирать

Линейка Gemini 3 разделена по нагрузке, а не по «уму»:

• gemini-3.7-flash — под сложный код, агентные сценарии и многошаговые задачи, где важна надёжность выполнения.
• gemini-3.6-flash — баланс скорости и мультимодальности для повседневных задач.
• gemini-3.5-flash — базовая рабочая лошадка для рутины и высокого потока запросов.
• gemini-3.5-flash-lite и gemini-3.1-flash-lite — самые дешёвые варианты под массовые простые операции: классификацию, извлечение полей, разметку.
• Отдельно — модели эмбеддингов, TTS, Live-режима и агентные (Deep Research, Computer Use).

Модели поколения 2.5 ещё работают, но выводятся — закладываться на них в новом проекте не стоит. Правило подбора: начинайте с дешёвой Flash-Lite и поднимайтесь вверх только там, где качество проседает. Сравнение с конкурентами по ценам и лимитам — в заметке «Сравнение API: Gemini, Claude и OpenAI».

Get code: из песочницы в проект

Кнопка Get code превращает текущее состояние чата — модель, параметры, системную инструкцию, историю — в готовый фрагмент на нужном языке. Минимальный запрос на Python:

pip install -U google-genai

from google import genai

client = genai.Client()

response = client.models.generate_content(
    model="gemini-3.5-flash",
    contents="Объясни, что такое эмбеддинг, в двух предложениях"
)

print(response.text)

То же самое голым HTTP-запросом, если SDK не нужен:

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{"contents":[{"parts":[{"text":"Привет!"}]}]}'

Обратите внимание: актуальный SDK называется google-genai, а не старый google-generativeai. Подробный разбор первого запроса — в заметке «Gemini API: как получить ключ и сделать первый запрос».

Ключи: важная миграция 2026 года

Из-за этого пункта ломаются рабочие проекты, поэтому проверьте его отдельно. Google переводит Gemini API со старых «стандартных» ключей на ключи авторизации (auth keys) — они привязаны к сервисному аккаунту Google Cloud, поддерживают гранулярные права и быструю блокировку утёкшего ключа.

• С 19 июня 2026 года API отклоняет запросы от стандартных ключей без ограничений. Стандартные ключи с явно настроенными ограничениями пока продолжают работать.
• С сентября 2026 года отклоняются все запросы от стандартных ключей — миграция обязательна.

Новые ключи, которые вы создаёте в AI Studio сегодня, уже создаются как ключи авторизации, так что при старте с нуля делать ничего не нужно. А вот у проектов, заведённых раньше, ключ надо перевыпустить.

Базовая гигиена прежняя: ключ живёт в переменной окружения, а не в коде и тем более не во фронтенде; продакшен-ключи — в Secret Manager; на биллинг вешаются алерты. При компрометации: выпустить новый ключ, обновить приложение, проверить, и только затем отключить старый.

Что реально бесплатно, а что вы платите данными

Бесплатный уровень щедрый: основные Flash-модели на нём доступны без оплаты, ограничения выражены в запросах в минуту, токенах в минуту и запросах в сутки. Точные цифры Google больше не публикует статической таблицей — актуальные лимиты вашего аккаунта видны на странице rate limits в самом AI Studio.

Главная плата за бесплатный уровень — не деньги, а данные. По условиям использования Gemini API содержимое ваших запросов и ответов на бесплатном уровне применяется для улучшения продуктов Google, включая машинное обучение, а живые рецензенты могут читать и размечать эти данные (перед просмотром они отвязываются от аккаунта). В документации прямым текстом: не отправляйте конфиденциальную и персональную информацию.

На платном уровне противоположное правило: промпты и ответы не используются для улучшения продуктов, логи хранятся недолго и только для контроля злоупотреблений. Ориентиры по ценам платного уровня за миллион токенов: Gemini 3.7 и 3.6 Flash — $0,75 на вход и $3,75 на выход (с 1 января 2027 года тариф удваивается), Gemini 3.5 Flash — $1,50 и $9,00, Flash-Lite — $0,30 и $2,50.

Вывод простой: прототипы и учебные эксперименты — на бесплатном уровне, данные клиентов и коммерческая переписка — только на платном. Как выстроить это правило в команде: «Как не слить данные через ИИ». Как не разориться на токенах: «Токены и лимиты: как считать и экономить».

Доступ из России

Google публикует список стран и территорий, где доступны Gemini API и AI Studio. России и Беларуси в нём нет. Практически это означает три вещи.

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

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

Частые ошибки новичков

• Крутить температуру вместо промпта. В девяти случаях из десяти проблема не в параметрах генерации, а в формулировке задачи. Приёмы — в заметке «Промпт-инжиниринг: практические приёмы».
• Тестировать в чате, а в код нести другую модель. Ответ подбирали на 3.7 Flash, а в проде поставили Flash-Lite ради экономии — и удивляются деградации. Тестируйте ту модель, которую собираетесь запускать.
• Забыть системную инструкцию при переносе. Она задаётся отдельным полем и теряется, если код копируют вручную, а не через Get code.

Вывод

Google AI Studio закрывает самый неудобный этап работы с моделями — тот, где вы ещё не знаете, получится ли вообще. Промпт подбирается в браузере за минуты, Get code переносит результат в проект без расхождений, а Build собирает прототип раньше, чем вы напишете первую строчку. Помните о двух вещах: перевести ключи на новый формат до сентября 2026 года и не отправлять на бесплатный уровень ничего, что не хотелось бы увидеть в обучающей выборке.