Ключ Gemini API: инструкция

Свой ключ Gemini API в приложении, без кода

Как получить ключ Gemini API в Google AI Studio, чем отличаются бесплатный и платный уровни и как пользоваться Gemini в чате на телефоне или в вебе.

Oriveo TeamОпубликовано Обновлено 7 мин чтения
  • Чтобы пользоваться Gemini со своим ключом и без кода, создайте API-ключ в Google AI Studio (aistudio.google.com/apikey) и вставьте его в BYOK-чат, например в Oriveo. Дальше запросы оплачиваются или учитываются в лимитах бесплатного уровня в проекте Google Cloud, к которому привязан ключ.
  • У Gemini API есть бесплатный уровень для многих моделей, в том числе семейства Flash, но Google может использовать содержимое запросов на бесплатном уровне для улучшения своих продуктов, а некоторые модели, например Gemini 3.1 Pro Preview, доступны только за плату.
  • На платном уровне по состоянию на 28 сентября 2026 года Gemini 3.8 Flash стоит $0,75 за миллион входных токенов и $3,75 за миллион выходных, то есть заметно меньше цента за типичное сообщение в чате, это оценка.
Oriveo на iPhone: список чатов, справа от каждого — примерная стоимость.

Чем Gemini API отличается от приложения Gemini

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

API управляется в Google AI Studio и опирается на проект Google Cloud. В документации Google сказано, что каждый ключ Gemini API связан с проектом Google Cloud и что именно в проекте настраиваются оплата, участники и права. Лимиты запросов действуют на проект, а не на отдельный ключ. Платное использование API включается привязкой платёжного аккаунта Cloud к проекту, поэтому не стоит думать, что потребительский тариф Google AI оплачивает API-запросы.

Шаг 1. Создайте ключ Gemini API

Ключ создаётся за минуту, и для бесплатного уровня банковская карта не нужна. Если вы впервые в AI Studio, после принятия условий сервиса он сам создаст для вас проект Google Cloud по умолчанию и API-ключ.

  • Откройте aistudio.google.com/apikey и войдите в аккаунт Google.
  • Примите условия сервиса, если их предложат: у новых пользователей проект и ключ создаются автоматически.
  • Создайте API-ключ или скопируйте уже созданный и запомните, к какому проекту он относится.
  • Сохраните ключ в надёжном месте, например в менеджере паролей. Ключи Gemini обычно начинаются с «AIza».

Шаг 2. Решите, какой уровень вам нужен: бесплатный или платный

В случае с Gemini это самое важное решение, ведь два уровня отличаются не только ценой. На странице цен для каждой модели указано, доступен ли бесплатный уровень («Free of charge») или нет («Not available»), а ещё сказано, как обрабатывается ваше содержимое на каждом уровне.

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

Различаются и лимиты запросов. Проект без оплаты работает на бесплатном уровне. Подключение действующего платёжного аккаунта переводит его на Tier 1, а более высокие уровни открываются по мере накопленных трат. Лимиты зависят от модели: Google пишет, что они показаны в AI Studio и обновляются автоматически при смене уровня.

Шаг 2. Решите, какой уровень вам нужен: бесплатный или платный
Бесплатный уровеньПлатный уровень (оплата подключена)
Цена за токеныНет, для моделей с пометкой «Free of charge»Опубликованные цены за токены
Какие модели доступныМногие, в том числе Flash; некоторые превью-версии Pro недоступныВсе модели из списка
Использование содержимого, по данным страницы цен GoogleИспользуется для улучшения продуктов GoogleНе используется для улучшения продуктов Google
Лимиты запросовЛимиты бесплатного уровня на проектTier 1 и выше, на проект

Сколько стоит Gemini на платном уровне

В таблице — опубликованные Google цены платного уровня для трёх актуальных моделей на 28 сентября 2026 года для запросов до 200 000 токенов и примерная стоимость типичного сообщения в чате: 2 000 входных и 600 выходных токенов. Обратите внимание на цену Gemini 3.8 Flash с датами: Google указывает $0,75 за вход и $3,75 за выход до 31 декабря 2026 года и $1,50 за вход и $7,50 за выход с 1 января 2027 года.

Для Gemini 3.8 Flash расчёт такой: 2 000 × $0,75 / 1 000 000 + 600 × $3,75 / 1 000 000 = $0,00375, то есть меньше половины цента. Длинные переписки обходятся дороже за сообщение, потому что предыдущие реплики отправляются заново как входные токены. Окончательная сумма — в счёте Google.

Сколько стоит Gemini на платном уровне
МодельВход (USD за 1 млн токенов)Выход (USD за 1 млн токенов)Бесплатный уровеньПримерная стоимость типичного сообщения
Gemini 2.5 Flash-Lite0,100,40Free of chargeоколо $0,0004
Gemini 3.8 Flash0,75 (1,50 с 1 января 2027)3,75 (7,50 с 1 января 2027)Free of chargeоколо $0,004
Gemini 3.1 Pro Preview2,0012,00Not availableоколо $0,011

Шаг 3. Добавьте ключ в Oriveo

Oriveo — чат с несколькими моделями для iPhone, Android и веба, который работает с вашими собственными ключами. Google Gemini — один из его 15 официальных провайдеров, он лежит в разделе «Прямо к официальным сервисам AI». Названия в таблице — те, что приложение показывает по-русски.

Когда вы нажмёте «Продолжить», Oriveo проверит ключ: запросит у Google список доступных моделей и подтянет его. Если Google отклонит ключ, вы узнаете об этом сразу и сможете исправить его до начала чата.

Шаг 3. Добавьте ключ в Oriveo
ШагiPhoneAndroidВеб
Открыть список провайдеровВкладка «Провайдеры»Вкладка «Провайдеры»«Провайдеры» в боковой панели
Начать подключение«Добавить поставщика»«Добавить поставщика»«Добавить поставщика»
Выбрать провайдераGoogle Gemini, раздел «Прямо к официальным сервисам AI»Google Gemini, раздел «Прямо к официальным сервисам AI»Google Gemini, раздел «Прямо к официальным сервисам AI»
Вставить ключПоле «API-ключ» под заголовком «Подключить Google Gemini»Поле «API-ключ» под заголовком «Подключить Google Gemini»Поле ключа; ссылка «Получите ключ на Google Gemini» ведёт в AI Studio
Подтвердить«Продолжить»«Продолжить»«Продолжить»

Шаг 4. Выберите модель и общайтесь

Когда ключ подключён, модели Gemini появляются в списке выбора. Модели Flash быстрые и недорогие, их хватает для большей части повседневного общения. Модели Pro нужны для более сложных рассуждений и длинного анализа. Если ваш ключ на бесплатном уровне, берите модели, которые на странице цен помечены как бесплатные: платные без подключённой оплаты будут отвечать ошибкой.

Модель можно сменить прямо в ходе разговора, в том числе на модель другого подключённого провайдера, и продолжить в той же переписке. У каждого сообщения показана примерная стоимость по опубликованной цене Google. На бесплатном уровне помните: реальная плата за бесплатные модели равна нулю, а ограничивают вас лимиты запросов.

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

Ошибки Gemini обычно достаточно конкретны, чтобы указать на причину.

  • «API key not valid»: ключ скопирован не полностью, удалён или ограничен. Скопируйте его заново из AI Studio или создайте новый.
  • Ошибка лимита или «resource exhausted»: вы упёрлись в минутный или дневной лимит проекта для этой модели. Подождите, смените модель или подключите оплату ради более высоких лимитов.
  • Модель недоступна на вашем уровне: некоторые модели только платные. Подключите оплату к проекту или выберите модель, которая бесплатна.
  • Несколько ключей упираются в лимит одновременно: лимиты действуют на проект, поэтому ключи в одном проекте делят их между собой.

Как уберечь ключ

Ключ Gemini после подключения оплаты позволяет тратить деньги, а бесплатную квоту он может исчерпать и раньше. Oriveo хранит ключи провайдеров на вашем устройстве или в браузере, а не как записи в аккаунте. Приложения для iPhone и Android отправляют запросы в Google напрямую. Веб-версия работает через промежуточный сервер, который пересылает запросы провайдеру в реальном времени и не сохраняет ни ключ, ни содержимое BYOK-чатов. Наценки к ценам Google Oriveo не добавляет.

Заведите отдельный проект или ключ под чат-приложение, проверяйте расход в AI Studio и в консоли Cloud и удаляйте любой ключ, который мог оказаться в чужих руках.

Вопросы и ответы

Gemini API бесплатный?
Отчасти. У многих моделей Gemini есть бесплатный уровень в рамках лимитов запросов, но некоторые модели, например Gemini 3.1 Pro Preview, только платные. Ещё на странице цен Google сказано, что содержимое на бесплатном уровне используется для улучшения продуктов Google, а на платном — нет.
Где взять ключ Gemini API?
В Google AI Studio: aistudio.google.com/apikey. У новых пользователей после принятия условий появляются проект Google Cloud по умолчанию и ключ. Каждый ключ принадлежит проекту Cloud, где настраиваются оплата и лимиты запросов.
Покрывает ли подписка Google AI Pro использование Gemini API?
Не рассчитывайте на это. Потребительские тарифы Google AI относятся к приложению Gemini, а платное использование Gemini API включается привязкой платёжного аккаунта Cloud к проекту вашего ключа. Проверьте оплату проекта в AI Studio.
Сколько стоит Gemini со своим ключом?
На платном уровне по состоянию на 28 сентября 2026 года Gemini 3.8 Flash стоит $0,75 за миллион входных токенов и $3,75 за миллион выходных до 31 декабря 2026 года, то есть около $0,004 за типичное сообщение в чате, это оценка.
Можно ли использовать ключ Gemini API на iPhone и Android?
Можно. В Oriveo откройте «Провайдеры», нажмите «Добавить поставщика», выберите Google Gemini, вставьте ключ и нажмите «Продолжить». Нативные приложения отправляют запросы прямо в Google, а тот же ключ работает и в веб-версии.

Читайте также

Пользуйтесь Gemini со своим ключом

Добавьте ключ Gemini в Oriveo на iPhone, Android или в вебе, переключайтесь между Gemini и 700+ другими моделями и смотрите на примерную стоимость у каждого сообщения.