Настройка сверена с публичной документацией приложения и 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 --versionBash: окружение 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 — адреса, авторизацию и клиентские методы. Дата сверки: .