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