Gemini CLI через SoleAPI — две переменные окружения
SoleAPI нативно поддерживает протокол generateContent / streamGenerateContent, которым пользуется Gemini CLI: 10 моделей Google, автопереключение на резерв при 429 и 503 официального API. Пополнение через Alipay, оплата по факту, без абонентской платы.
# ~/.zshrc / ~/.bashrc
export GOOGLE_GEMINI_BASE_URL="https://api.soleapi.com"
export GEMINI_API_KEY="sk-sole-..."
gemini -m gemini-3.1-pro-previewЗачем шлюз, а не прямое подключение
Не замена Google, а слой поверх: стабильность, оплата и учёт — три вещи, которые вендор за вас не решает.
Автопереключение при 5xx / лимитах
У каждой модели несколько каналов. Когда Google отвечает 500, перегрузкой или лимитом, шлюз переключается на резерв до первого кадра — Gemini CLI ошибку не видит.
Пополнение через Alipay, оплата по факту
Без зарубежной карты и подписки. 1 Credit = ¥1, списывается по использованию; расходы видны по моделям и ключам в консоли.
Нативный протокол, стриминг без буфера
Gemini generateContent проходит напрямую без перевода; каждый SSE-кадр пересылается сразу, так что Gemini CLI стримит как при прямом подключении.
Подключить Gemini CLI за три шага
Три шага, сам Gemini CLI менять не нужно.
Регистрация и стартовый баланс
Регистрация по email даёт пробные Credits — хватит подключить реальный проект.
Создайте API-ключ
Консоль → API Keys → Создать. Ключу можно задать бюджет, ограничить модели и каналы.
Укажите SoleAPI и запустите Gemini CLI
Замените base URL на SoleAPI и ключ на только что созданный; остальное без изменений.
# ~/.zshrc / ~/.bashrc
export GOOGLE_GEMINI_BASE_URL="https://api.soleapi.com"
export GEMINI_API_KEY="sk-sole-..."
gemini -m gemini-3.1-pro-previewМодели и цены для Gemini CLI
Цена канала SoleAPI по умолчанию в Credits (1 Credit = ¥1); зачёркнуто — официальная цена. Нажмите на модель для полного прайса, протоколов и доступности.
| Модель | Контекст | Ввод / M | Вывод / M | Доступность за 7 дней |
|---|---|---|---|---|
| Gemini 3.1 Flash Lite Imagegemini-3.1-flash-lite-image | 64K | — | ||
| Gemini 2.5 Flashgemini-2.5-flash | 1M | 99.1% | ||
| Gemini 2.5 Flash Imagegemini-2.5-flash-image | 64K | — | ||
| Gemini 3 Flash Previewgemini-3-flash-preview | 1M | 96.8% | ||
| Gemini 3.1 Flash Imagegemini-3.1-flash-image | 128K | — | ||
| Gemini 3.7 Flashgemini-3.7-flash | 1M | 98.0% |
Те же данные, что в каталоге моделей, обновление каждые 5 минут. Все 10 моделей Google →
Частые ошибки Gemini CLI и как их гасит шлюз
Эти ошибки идут от официального API Google. Через SoleAPI шлюз повторяет запрос и переключается до первого кадра, так что Gemini CLI их обычно не показывает.
429 RESOURCE_EXHAUSTEDИсчерпана официальная квота
Бесплатный уровень исчерпал запросы в минуту / день, или платный проект упёрся в RPM. SoleAPI: квота делится между несколькими ключами; когда один отвечает 429, работает следующий.
503 UNAVAILABLE: The model is overloadedПерегрузка у вендора
В пиковые часы Google отклоняет запросы. SoleAPI: каналы планируются по состоянию; перегруженный понижается, запросы идут через здоровый.
400 API key not validКлюч не соответствует base URL
Base URL указывает на SoleAPI, а ключ остался от AI Studio, или наоборот. SoleAPI: base URL и ключ идут парой — api.soleapi.com работает с ключом, начинающимся на sk-sole-.
Request timed outДолго нет ответа
Официальная сторона так и не прислала первый кадр. SoleAPI: таймаут до первого кадра повторяется через другой канал; после него каждый кадр пересылается сразу, без буфера.
Вопросы и ответы
Безопасен ли шлюз для Gemini CLI? Кто-то увидит мой код?
Ключи, email и другие чувствительные строки маскируются перед пересылкой; трафик шифруется на всём пути; ваши запросы не используются для обучения моделей. Ключ можно ограничить моделями и бюджетом и отозвать одним кликом.
Чем это отличается от прямого подключения к Google?
Тот же протокол (generateContent напрямую), те же модели, плюс три вещи: автопереключение при сбоях официального API, пополнение через Alipay со счётом в юанях и контроль расходов и бюджета по ключам.
Работает ли с Claude Code и Codex?
Да. Поддерживаются также Anthropic Messages и OpenAI Responses — укажите в каждом инструменте base URL SoleAPI. Все инструменты используют один API-ключ и один баланс.
Как пополнить и есть ли минимум?
Консоль → Кошелёк, принимается Alipay; 1 Credit = ¥1, оплата по использованию, без абонентской платы и минимума. Перед исчерпанием баланса придёт письмо.
Две переменные окружения — и Gemini CLI работает стабильно
Стартовый баланс при регистрации, оплата по факту, без абонентской платы.