Gemini CLI через WandAPI — две переменные окружения
WandAPI нативно поддерживает протокол generateContent / streamGenerateContent, которым пользуется Gemini CLI: 0 моделей Google, автопереключение на резерв при 429 и 503 официального API. Пополнение через Alipay, оплата по факту, без абонентской платы.
# ~/.zshrc / ~/.bashrc
export GOOGLE_GEMINI_BASE_URL="https://api.wandapi.com"
export GEMINI_API_KEY="sk-sole-..."
gemini -m model-idЗачем шлюз, а не прямое подключение
Не замена Google, а слой поверх: стабильность, оплата и учёт — три вещи, которые вендор за вас не решает.
Автопереключение при 5xx / лимитах
У каждой модели несколько каналов. Когда Google отвечает 500, перегрузкой или лимитом, шлюз переключается на резерв до первого кадра — Gemini CLI ошибку не видит.
Пополнение через Alipay, оплата по факту
Без зарубежной карты и подписки. 1 Credit = ¥1, списывается по использованию; расходы видны по моделям и ключам в консоли.
Нативный протокол, стриминг без буфера
Gemini generateContent проходит напрямую без перевода; каждый SSE-кадр пересылается сразу, так что Gemini CLI стримит как при прямом подключении.
Подключить Gemini CLI за три шага
Три шага, сам Gemini CLI менять не нужно.
Регистрация и стартовый баланс
Регистрация по email даёт пробные Credits — хватит подключить реальный проект.
Создайте API-ключ
Консоль → API Keys → Создать. Ключу можно задать бюджет, ограничить модели и каналы.
Укажите WandAPI и запустите Gemini CLI
Замените base URL на WandAPI и ключ на только что созданный; остальное без изменений.
# ~/.zshrc / ~/.bashrc
export GOOGLE_GEMINI_BASE_URL="https://api.wandapi.com"
export GEMINI_API_KEY="sk-sole-..."
gemini -m model-idЧастые ошибки Gemini CLI и как их гасит шлюз
Эти ошибки идут от официального API Google. Через WandAPI шлюз повторяет запрос и переключается до первого кадра, так что Gemini CLI их обычно не показывает.
429 RESOURCE_EXHAUSTEDИсчерпана официальная квота
Бесплатный уровень исчерпал запросы в минуту / день, или платный проект упёрся в RPM. WandAPI: квота делится между несколькими ключами; когда один отвечает 429, работает следующий.
503 UNAVAILABLE: The model is overloadedПерегрузка у вендора
В пиковые часы Google отклоняет запросы. WandAPI: каналы планируются по состоянию; перегруженный понижается, запросы идут через здоровый.
400 API key not validКлюч не соответствует base URL
Base URL указывает на WandAPI, а ключ остался от AI Studio, или наоборот. WandAPI: base URL и ключ идут парой — api.wandapi.com работает с ключом, начинающимся на sk-sole-.
Request timed outДолго нет ответа
Официальная сторона так и не прислала первый кадр. WandAPI: таймаут до первого кадра повторяется через другой канал; после него каждый кадр пересылается сразу, без буфера.
Вопросы и ответы
Безопасен ли шлюз для Gemini CLI? Кто-то увидит мой код?
Ключи, email и другие чувствительные строки маскируются перед пересылкой; трафик шифруется на всём пути; ваши запросы не используются для обучения моделей. Ключ можно ограничить моделями и бюджетом и отозвать одним кликом.
Чем это отличается от прямого подключения к Google?
Тот же протокол (generateContent напрямую), те же модели, плюс три вещи: автопереключение при сбоях официального API, пополнение через Alipay со счётом в юанях и контроль расходов и бюджета по ключам.
Работает ли с Claude Code и Codex?
Да. Поддерживаются также Anthropic Messages и OpenAI Responses — укажите в каждом инструменте base URL WandAPI. Все инструменты используют один API-ключ и один баланс.
Как пополнить и есть ли минимум?
Консоль → Кошелёк, принимается Alipay; 1 Credit = ¥1, оплата по использованию, без абонентской платы и минимума. Перед исчерпанием баланса придёт письмо.
Две переменные окружения — и Gemini CLI работает стабильно
Стартовый баланс при регистрации, оплата по факту, без абонентской платы.