Gemini CLI の接続先を環境変数 2 つで WandAPI に
WandAPI は Gemini CLI が使う generateContent / streamGenerateContent プロトコルにネイティブ対応：Google モデル 0 種類、公式が 429 や 503 を返すと自動でバックアップ経路へ。Alipay チャージ、従量課金、月額費用なし。
# ~/.zshrc / ~/.bashrc
export GOOGLE_GEMINI_BASE_URL="https://api.wandapi.com"
export GEMINI_API_KEY="sk-sole-..."
gemini -m model-id公式に直接つなぐのではなく、ゲートウェイを使う理由
Google の代わりではなく、その上に一層：安定性・決済・請求という、公式が代わりに解決してくれない 3 つのこと。
5xx / レート制限時に自動切替
1 つのモデルに複数の供給経路。Google が 500・過負荷・レート制限を返すと、ゲートウェイは最初のフレームの前にバックアップへ切り替え、Gemini CLI にはエラーが見えません。
Alipay でチャージ、従量課金
海外カードもサブスクも不要。1 Credit = ¥1、使った分だけ課金。請求はモデル別・キー別にコンソールで確認できます。
ネイティブプロトコル、バッファなし転送
Gemini generateContent をそのまま直通、変換なし。SSE の各フレームを受信次第転送するため、Gemini CLI のストリーミング体験は直結と同じです。
3 ステップで Gemini CLI を接続
3 ステップ、Gemini CLI 本体の変更は不要。
登録して無料枠を受け取る
メール登録で無料 Credits を付与。実プロジェクトの接続テストに十分な量です。
API Key を作成
コンソール → API Key → 新規作成。予算・モデル・チャネルの制限も設定できます。
WandAPI に向けて Gemini CLI を起動
Base URL を WandAPI に、Key を作成したものに差し替えるだけ。ほかはそのまま。
# ~/.zshrc / ~/.bashrc
export GOOGLE_GEMINI_BASE_URL="https://api.wandapi.com"
export GEMINI_API_KEY="sk-sole-..."
gemini -m model-idGemini CLI でよくあるエラーとゲートウェイの対処
これらのエラーは Google 公式 API 側のものです。WandAPI 経由なら最初のフレームの前にゲートウェイが再試行・切替するため、Gemini CLI ではほぼ見えません。
429 RESOURCE_EXHAUSTED公式のクォータ上限
無料枠の分 / 日あたりリクエスト数を使い切ったか、有料プロジェクトの RPM 上限。 WandAPI：複数の上流キーでクォータを分散。1 本が 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 の中継は安全ですか？コードは見られませんか？
転送前にキーやメールアドレスなどの機密情報を自動でマスク。通信は全経路暗号化。リクエストデータをモデル学習に使うことはありません。キーはモデル・予算を制限でき、漏洩時はワンクリックで失効できます。
Google 公式に直接つなぐのと何が違いますか？
プロトコル（generateContent 直通）もモデルも同じ。加わるのは 3 つ：公式障害時の自動切替、Alipay チャージと人民元建て請求、キー単位の使用量・予算管理です。
Claude Code や Codex でも使えますか？
使えます。Anthropic Messages と OpenAI Responses プロトコルにも対応、各ツールの Base URL を WandAPI に向けるだけ。すべてのツールで API Key と残高を共有します。
チャージ方法と最低額は？
コンソール → ウォレット、Alipay 対応。1 Credit = ¥1 の従量課金で月額費用や最低利用額はありません。残高不足時は事前にメールでお知らせします。
環境変数 2 つで、Gemini CLI を安定稼働
登録で無料枠付与、従量課金、月額費用なし。