Gemini берут в личный ассистент по двум причинам, и обе выглядят как чистая выгода: очень длинное окно контекста и бесплатный уровень, который дают сразу после получения ключа. Ошибка начинается там, где эти две причины складывают. «Огромный контекст плюс бесплатно» на практике означает «бесплатный уровень закончится тем быстрее, чем активнее вы пользуетесь длинным контекстом»: квоты бесплатного уровня считаются в том числе в токенах, а длинный контекст — это способ потратить много токенов на один запрос.
Разберём обе причины по отдельности: сначала как получить ключ, потом — что на самом деле означает бесплатный уровень и длинное окно.
#Что понадобится
- Аккаунт Google.
- Доступ к домену студии разработчика. Из России, по проверке 26 августа 2026 года, требовались дополнительные средства доступа — параметр меняющийся, проверьте на день чтения.
- Карта — только если планируете выходить за пределы бесплатного уровня.
#Шаг 1. Получить ключ в студии
Есть два способа работать с моделями Google, и путать их не стоит.
Простой путь — студия разработчика. Открываете aistudio.google.com, входите под аккаунтом Google, находите кнопку получения API-ключа, соглашаетесь с условиями и получаете строку, начинающуюся с AIza. Проект в облаке создаётся автоматически, платёжные данные не требуются.
Корпоративный путь — облачная платформа. Отдельный проект, привязанная биллинг-аккаунт, служебные учётные данные вместо простого ключа, другая тарификация и другие условия по данным. Нужен, если вы работаете от организации или вам важны гарантии по региону обработки. Для личного ассистента избыточен.
Дальше речь идёт о простом пути.
#Шаг 2. Подключить в Persona
На странице /settings/llm выберите пункт Google Gemini, вставьте ключ AIza... и сохраните. Формат протокола у Google свой, но приложение берёт различия на себя — вписывать адрес эндпоинта не нужно.
Ключ участника хранится в базе Persona в открытом виде, поэтому правило то же, что и для других провайдеров: отдельный ключ для приложения, а не общий на все случаи. Ключ вида AIza при утечке позволяет тратить квоту вашего проекта, поэтому в публичный репозиторий он не должен попасть ни при каких обстоятельствах.
#Проверка результата
- Отправьте один короткий вопрос в чат и получите ответ.
- Откройте студию и убедитесь, что ключ значится активным.
- Отправьте заведомо длинный текст — несколько страниц — и проверьте, что модель отвечает по его содержанию, а не по началу.
Третий пункт проверяет ровно то, ради чего вы, скорее всего, и берёте этот провайдер.
#Что на самом деле означает бесплатный уровень
Бесплатный уровень у Google существует и заметен — это правда. Что за ним стоит:
- Квоты считаются минимум в трёх измерениях: запросы в минуту, запросы в сутки и токены в минуту. Упереться можно в любое, а ошибка приходит одна и та же.
- Квоты различаются по моделям. У компактной модели они шире, у флагманской — уже, иногда в разы.
- Бесплатный уровень доступен не во всех регионах. Это отдельное условие, не связанное с наличием ключа.
- Условия по данным на бесплатном уровне отличаются от платного. Исторически именно бесплатный доступ у крупных вендоров сопровождался правом использовать содержание запросов для улучшения сервисов. Это требует проверки на день чтения в актуальном соглашении: условие менялось. Как читать такие документы — в материале про политики провайдеров по обучению на пользовательских данных.
Конкретных чисел квот мы здесь не печатаем: они пересматривались неоднократно и по каждой модели отдельно. Актуальные значения лежат на странице лимитов в документации, и смотреть их нужно в тот день, когда вы планируете нагрузку. Сравнение бесплатных уровней разных провайдеров по критерию «хватит ли на реальный день» — в разборе бесплатных API языковых моделей.
#Что на самом деле означает длинный контекст
Заявленное окно контекста у части моделей Google измеряется сотнями тысяч токенов, а у отдельных версий — заявляется до миллиона. Это настоящая техническая возможность, и она решает задачи, которые иначе требуют сложной нарезки документов.
Три оговорки, которые превращают восторг в рабочий инструмент.
Заявленное окно и удерживаемое внимание — разные вещи. Модель принимает миллион токенов, но качество работы с материалом в середине длинного окна обычно ниже, чем с началом и концом. Подробный разбор этого эффекта — в статье про контекстное окно на миллион токенов.
Длинный вход стоит денег и квоты. На платном уровне вы платите за каждый входной токен; на бесплатном — расходуете минутную и суточную квоту. Отправлять весь архив в каждый запрос — самый дорогой способ работать с памятью.
Окно контекста — не единственный лимит. Есть ещё максимум входа за один запрос и максимум генерируемого ответа, и обрыв ответа на середине объясняется именно последним. Разбор всех трёх — в материале про лимиты контекста и вывода у провайдеров.
#Что может пойти не так
- Ошибка о недоступности в вашем регионе. Относится и к ключу, и к бесплатному уровню отдельно: ключ может работать, а бесплатная квота — нет.
- Ошибка о превышении квоты через минуту работы. Сработал минутный лимит. Пауза между запросами решает; агентный режим, дёргающий модель подряд, — нет.
- Модель отвечает не по всему документу. Проверьте, не обрезает ли текст само приложение перед отправкой, и не превышен ли максимум входа за запрос.
- Ответ обрывается на середине фразы. Упёрлись в лимит длины ответа, а не контекста. Это отдельная настройка.
- Ключ работает у вас, но не работает на сервере. Регион определяется по адресу, с которого уходит запрос, а не по вашему браузеру.
#Частые вопросы
#Нужна ли карта, чтобы получить ключ Gemini?
Для ключа из студии разработчика — нет, он выдаётся по аккаунту Google. Карта нужна только для перехода на платный уровень с более широкими квотами. Это одно из немногих условий у крупных вендоров, где бесплатный старт действительно бесплатен, но проверять его стоит на день регистрации.
#Правда ли, что на бесплатном уровне запросы используются для обучения?
Условия бесплатного и платного доступа у крупных вендоров исторически различались именно в этом пункте. Утверждать текущее положение дел без проверки мы не будем: читайте актуальное соглашение в день подключения. Если ответ принципиален, а полагаться на изменяемый документ вы не готовы, рассматривайте локальную модель.
#Стоит ли отправлять в модель весь архив заметок ради длинного контекста?
Обычно нет. Это дорого по токенам, медленно и не даёт выигрыша в качестве по сравнению с осмысленной выборкой релевантных фрагментов. Длинное окно полезно там, где документ действительно нужен целиком: договор, длинная переписка, большой файл кода.
#Чем ключ из студии отличается от доступа через облачную платформу?
Ключ из студии — это простая строка и мгновенный старт с бесплатным уровнем. Облачная платформа даёт контроль над регионом обработки, служебные учётные данные, корпоративную тарификацию и договорные условия. Для личного использования первый вариант проще; для работы от организации второй, как правило, обязателен.
#Что делать, если из моей страны доступа нет?
Смотреть провайдеров, которые открываются без ограничений, российские шлюзы или собственную модель. Полный разбор вариантов — в обзоре того, где взять ключ к языковой модели.