API429 / Gemini CLI

Gemini CLI с API429: ключ и Google GenerateContent

Gemini CLI использует собственный Google GenerateContent контракт. Для подключения API429 нужен режим Gemini API key, origin шлюза без /v1 и точный ID gemini-3.8-flash. Здесь разобраны установка, переменные окружения и границы проверки. Настройка OpenAI Compatible из другого редактора не переносится в этот клиент простой заменой названия модели.

Настройка сверена с публичной документацией приложения и API429. Полный запуск в Gemini CLI, импорт в установленный клиент и агентные сценарии здесь не подтверждены. Начните с короткого несекретного запроса и проверьте ответ в своей версии.

Параметры подключения

Протокол
Google GenerateContent
Режим соединения
Gemini API key (x-goog-api-key)
Base URL
https://gateway.api429.com
Точный ID для проверки
gemini-3.8-flash

Доступ конкретного ключа проверяйте через GET /v1/models. Публичная карточка модели не гарантирует её доступность в приложении. Храните ключ в предусмотренном приложением защищённом хранилище или в окружении текущей сессии. Не передавайте значение ключа аргументом команды и не сохраняйте его в общих файлах проекта.

Версия клиента и действующий способ доступа

Сверьте требования с официальной установкой Gemini CLI: для наблюдавшегося пакета 0.65.0 требуется Node.js версии 20 или новее. На странице изменений при проверке была видна версия 0.64.0 от 13 октября. Это разные наблюдения о документации и npm, поэтому номер пакета не выдаётся за результат запуска на вашей системе. Пример фиксирует установленную версию, а не автоматически выбирает будущую latest.

Объявление Google о переходе к Antigravity касается прекращения consumer free, Pro и Ultra Code Assist requests с 18 июня 2026 года. Оно не означает, что любой API-key или enterprise путь Gemini CLI закрыт. Эта инструкция относится именно к платному API-key пути. Она не обещает переноса настроек на Antigravity CLI: для другого приложения отдельно нужны подтверждённые параметры и контракт подключения.

Переменные и выбор Gemini API key

В текущей Bash-сессии задайте GEMINI_MODEL=gemini-3.8-flash, GOOGLE_GEMINI_BASE_URL=https://gateway.api429.com и GOOGLE_GENAI_API_VERSION=v1beta. Значение base URL здесь является origin: добавлять /v1 из OpenAI-примера нельзя. Секрет GEMINI_API_KEY вводится скрыто. Не записывайте его в файл проекта, командную строку с открытым значением или общий пример настроек; после выхода из клиента удалите переменную из сессии.

При выборе авторизации используйте Use Gemini API key, которому соответствует режим gemini-api-key. Google login и Vertex — отдельные пути с другими ожиданиями к учётным данным. Существующие пользовательские настройки могут иметь приоритет или сохранять ранее выбранный способ входа. Перед первым запросом проверьте фактически выбранный режим в своей версии, не стирая настройки других рабочих окружений и не публикуя их содержимое.

Нативный запрос и диагностика пути

Публичный справочник API429 документирует /v1beta/models/{model}:generateContent, :streamGenerateContent и :countTokens; отдельно перечислены /gemini/v1beta алиасы. Ключ передаётся заголовком x-goog-api-key. Тело Google содержит contents и parts. Это отличается от messages в Chat Completions и input в Responses: успешный запрос другим методом не доказывает, что CLI отправляет нужное тело и получает ожидаемые события.

При ошибке пути проверьте отсутствие лишнего /v1, версию v1beta и точный ID модели. При отказе авторизации проверьте способ входа и наличие переменной, не выводя её значение. Доступность модели проверяйте для своего ключа; публикация модели в общем каталоге недостаточна. Для первой ручной проверки используйте пустую папку и короткую несекретную задачу. Если ответ не получен, сначала разберите код и безопасные поля ошибки, а не запускайте серию повторов.

Инструменты, контекст и контроль расходов

Нативные методы генерации не устанавливают поддержку всего агентного окружения. MCP, инструменты, sandbox, сохранённая авторизация и полный рабочий цикл Gemini CLI с API429 здесь не выполнялись. Не подключайте к первой проверке рабочие репозитории, интеграции и большие файлы. Отдельно оцените, какой контекст приложение собирает до отправки: короткая пользовательская фраза не всегда означает короткий оплачиваемый вход.

Начните с одного ручного действия и сверяйте использование в личном кабинете. CountTokens может помочь разбирать состав запроса, но сам по себе не является ограничителем итогового счёта или доказательством всех функций клиента. Гипотетическая оценка ниже использует семейство Google и точный ID, без переноса тарифов OpenAI. Наличие API-ключа не предоставляет подписку на приложение; повторы, дополнительные действия и условия доступа учитываются отдельно.

Настройки и примеры

Проверяемая версия и установка

node --version
npm install -g @google/gemini-cli@0.65.0
gemini --version

Bash: окружение Google API и ручной выбор API key

read -r -s -p "API429 key: " GEMINI_API_KEY
printf "\n"
export GEMINI_API_KEY
export GEMINI_MODEL=gemini-3.8-flash
export GOOGLE_GEMINI_BASE_URL=https://gateway.api429.com
export GOOGLE_GENAI_API_VERSION=v1beta
gemini
unset GEMINI_API_KEY GEMINI_MODEL GOOGLE_GEMINI_BASE_URL GOOGLE_GENAI_API_VERSION

Расход и следующие шаги

Гипотетический объём за час: 30 запросов к gemini-3.8-flash, каждый с 5 000 обычных входных и 512 выходными токенами, — около $0.05 по текущим ставкам API429. Кеш, инструменты, повторы, подписка приложения и другие сборы не включены. Дата каталога: .

Фактический расход зависит от числа запросов, длины контекста и ответов — смотрите его в личном кабинете API429.

Общий протокол OpenAI Compatible · Документация API429 · Помощь и диагностика

Оплата и тест $10

  • Карта российского банка. Пополнение баланса в личном кабинете.
  • Счёт для юрлиц. Безналичная оплата с закрывающими документами.
  • USDT и TON. Пополнение криптовалютой.

Тест $10. Подпишитесь на наш Telegram-канал через бота — получите $10 на баланс для первых запросов. Получить $10 в боте

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

Почему GOOGLE_GEMINI_BASE_URL указан без /v1?

Gemini CLI использует Google GenerateContent с версией v1beta. В этой конфигурации нужен origin https://gateway.api429.com, а не OpenAI base URL.

Какой способ авторизации выбрать в Gemini CLI?

Выберите Use Gemini API key, то есть gemini-api-key. Ключ берётся из GEMINI_API_KEY. Google login и Vertex не являются эквивалентными настройками.

Gemini CLI полностью закрыт после перехода к Antigravity?

Объявление прекращает consumer free/Pro/Ultra Code Assist requests, но сохраняет отдельные paid API-key и enterprise пути. Настройки Antigravity этим руководством не подтверждены.

Подтверждает ли GenerateContent работу MCP и sandbox?

Нет. Публично описанные методы генерации и подсчёта токенов отделены от полного агентного цикла. MCP, инструменты и sandbox в установленном CLI здесь не проверялись.

Источники

Справочник приложения определяет его интерфейс и ограничения; документация API429 — адреса, авторизацию и клиентские методы. Дата сверки: .

Telegram