halfoff.devДокументация
Получить ключ
Интеграции

Gemini CLI

Запускайте Gemini CLI через Half Off Dev за полцены официального Gemini с помощью двух переменных окружения и выберите модель Gemini.

Gemini CLI, терминальный помощник Google с открытым исходным кодом, работает по Gemini API, а Half Off Dev поддерживает этот API нативно. Две переменные окружения переключают его на Half Off Dev, после чего каждый вызов Gemini оплачивается за половину прайс-листа. Сначала создайте API-ключ.

Настройка#

Экспортируйте endpoint и ключ, затем запустите CLI с нужной моделью:

Shell
export GOOGLE_GEMINI_BASE_URL=https://halfoff.dev
export GEMINI_API_KEY=$HALFOFF_API_KEY
gemini -m gemini-3.1-pro

Используйте чистый origin: путь с версией API Gemini CLI добавит сам.

Или импортируйте из панели#

В разделе API-ключи выберите Use in tools → Gemini CLI, чтобы получить эти строки с подставленным ключом. Import with CC Switch настраивает Half Off Dev как провайдера в десктопном приложении CC Switch вместе с моделями (CC Switch должен быть установлен). Новый ключ уже в окне; для существующего вставьте ключ целиком, потому что Half Off Dev хранит только хеш.

Модели#

Флаг -m выбирает модель. Подходит любой id Gemini из GET /v1/models, например gemini-3.1-pro для сложных задач или gemini-3-flash для быстрых. Все id есть в списке моделей.

Исправление ошибок#

Что вы видитеЧто делать
401 Missing API keyКлюч не доходит до Half Off Dev. Экспортируйте GEMINI_API_KEY в оболочке, из которой запускается gemini.
401 Invalid or revoked API keyКлюч введён с ошибкой, обрезан или отозван. Вставьте его заново или создайте новый.
404 Model '...' is not availableТакого id нет. Скопируйте id Gemini из GET /v1/models или из списка моделей.
404 Unknown endpoint /v1/v1beta/...GOOGLE_GEMINI_BASE_URL заканчивается на /v1. Замените его на https://halfoff.dev.
402Баланс исчерпан или ключ достиг лимита расходов. См. Биллинг.

Остальные статусы описаны в разделе Ошибки.