Gemini API нужен, когда ИИ встраивают в приложение, скрипт или бэкенд, а не только открывают веб-чат. Ниже — как получить ключ в Google AI Studio, сделать первый запрос, выбрать семейство моделей и не перепутать веб-лимиты с квотами API. Отдельный troubleshooting: лимиты и ошибки Gemini API.
Чем API отличается от веб-чата Gemini
- Веб/приложение — диалог в интерфейсе Google; вход через аккаунт.
- API — программные запросы с API-ключом; биллинг и квоты смотрят в консоли/AI Studio.
- Ключ не заменяет вход на сайте Gemini и наоборот.
Если нужен просто чат на русском — начните с как пользоваться Gemini. Для разработчиков оставайтесь на этой странице.
Как получить ключ в AI Studio
- Войдите в Google AI Studio тем же Google-аккаунтом, с которым планируете разработку.
- Откройте раздел управления API-ключами.
- Создайте ключ и сохраните его в секрет-хранилище (не в публичный репозиторий).
- Ограничьте ключ по приложениям/IP, если консоль это позволяет для вашего проекта.
По состоянию на сентябрь 2026 точные пункты меню в AI Studio могут сдвигаться — ориентируйтесь на подписи «API key» / «Get API key» в интерфейсе.
Первый запрос: минимальный сценарий
Типичный путь: выбрать модель семейства Gemini → отправить текстовый prompt → прочитать ответ и usage. Для кода удобны официальные SDK и REST. Проверяйте:
- корректный заголовок/параметр с ключом;
- имя модели ровно как в документации вашего проекта;
- кодировку UTF-8 для русского текста;
- таймауты и ретраи на 429/5xx.
Русскоязычные промпты работают так же, как в чате: роль, формат, ограничения. Примеры задач — для текста, для кода.
Какую модель выбрать
Семейства Flash обычно берут для скорости и массовых вызовов; Pro — для более сложных рассуждений. Имена версий меняются — сверяйте список в AI Studio. Обзор линейки: Flash, Pro, хаб возможностей — что умеет Gemini.
Файлы, изображения и видео через API
Мультимодальные эндпоинты позволяют передавать изображения и, в отдельных продуктах, видео. Не обещайте себе недоступный метод: смотрите, что реально включено для ключа. Узкий long-tail по видео: анализ видео в Gemini API. Картинки в продуктовом слое — для изображений.
Типичные ошибки без выдуманных цен
- 403 / permission denied — ключ, проект, регион, отключённый API.
- 401 — неверный или отозванный ключ.
- 429 — квота или rate limit; снизьте частоту, проверьте лимиты в консоли.
- 400 — неверное имя модели или формат тела запроса.
Пошаговый разбор кодов — лимиты и ошибки. Цены и квоты не фиксируем в статье: они зависят от проекта и тарифа Google Cloud / AI Studio — смотрите биллинг в аккаунте.
Безопасность ключа
- Не коммитьте ключ в Git.
- Разделяйте ключи для dev и prod.
- Ротируйте ключ при утечке.
- Не путайте API-ключ с паролем Google-аккаунта — вход в чат: вход в Gemini.
Связь с доступом из России
Сетевые и региональные ограничения могут влиять и на API, и на веб. Контекст: Gemini в России, диагностика чата: не работает.
FAQ
Где взять ключ для старта?
Ключ создаётся в AI Studio; наличие free-тира и лимитов смотрите в интерфейсе проекта — без выдуманных цифр.
Почему 403 после создания ключа?
Часто не активирован нужный API, неверный проект или региональное ограничение. Чеклист: ошибки API.
Можно ли тем же ключом открыть веб-чат?
Нет. Чат — через аккаунт Google; API — отдельный доступ.
Как выбрать Flash или Pro в API?
По latency и сложности задачи; список имён — в AI Studio. Справка по именам: Gemini Pro.
Есть ли SDK на Python?
Да, у Google есть клиентские библиотеки; актуальные пакеты и примеры — в документации AI Studio / Cloud для вашей версии.
Куда смотреть биллинг?
В консоли проекта Google, привязанного к ключу. Суммы в ₽ здесь не указываем — они плавают по курсу и тарифу.
