ホーム / ガイド / カスタムエンドポイントと無料モデルで使う Gemini CLI

カスタムエンドポイントと無料モデルで使う Gemini CLI

Gemini CLI は、Google がターミナル向けに提供するオープンソースのコーディングエージェントです。リクエストを、カスタムのベース URL に送信できます。このガイドでは、Gemini CLI を FreeLLMAPI に向けます。FreeLLMAPI は、ネイティブの Gemini API を /v1beta で提供します。リクエストは無料プロバイダーのプールに送られます。このプールには、無料の Gemini API キーを含めることもできます。

コード、モデル名、ライブのカタログラベルは英語で表示します。

2026 年の Gemini CLI 無料枠の変更

最初にお読みください。Google は 2026 年に、Gemini CLI の無料利用を変更しました。Gemini CLI の上限ページには、「無料枠および Google One のユーザー: Gemini CLI は 2026 年 6 月 18 日に Antigravity CLI に置き換えられました。」と記載されています。

Google の発表によると、Gemini CLI は、有料の Gemini API キーとエンタープライズのお客様向けに引き続き利用できます。

  • 無料枠での Google ログイン: 個人アカウントでは、Gemini CLI による提供は終了しました。
  • カスタムのベース URL を使う Gemini API キー: Gemini CLI の設定リファレンスには、今も GOOGLE_GEMINI_BASE_URL が記載されています。この変数を設定すると、Gemini CLI はリクエストを Google ではなく、設定した URL に送信します。
  • 無料の Gemini API キー: Google AI Studio には、今も Gemini API の無料枠があります。FreeLLMAPI は、これらのキーを、ほかのプロバイダーのキーと一緒に使用できます。

このガイドでは 2 つ目の方法を使用します。FreeLLMAPI がリクエストに応答し、各リクエストをプール内の無料モデルに送信します。

手順 1: FreeLLMAPI と Gemini CLI をインストールする

両方をインストールする

curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @google/gemini-cli

http://localhost:3001 を開きます。Keys ページで、2 つ以上の無料プロバイダーのキーを追加します。無料の Google AI Studio キーは、最初のキーとして適しています。同じページで統合キーをコピーします。

手順 2: Gemini CLI をゲートウェイに向ける

2 つの環境変数を設定してから、Gemini CLI を起動します。ベース URL はサーバーのオリジンです。/v1beta は含めません。API のパスは Gemini CLI が自動的に追加します。

macOS または Linux

export GOOGLE_GEMINI_BASE_URL=http://localhost:3001
export GEMINI_API_KEY=<unified-key>
gemini

Windows PowerShell

$env:GOOGLE_GEMINI_BASE_URL="http://localhost:3001"
$env:GEMINI_API_KEY="<unified-key>"
gemini

Gemini CLI が認証方式を尋ねたら、Use Gemini API key を選択します。この選択を保存するには、~/.gemini/settings.json に設定します。

~/.gemini/settings.json

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
重要: GEMINI_API_KEY を使用してください。Gemini CLI の問題報告によると、バージョン 0.44.x では、GOOGLE_API_KEY を GOOGLE_GEMINI_BASE_URL と一緒に使うと、「Invalid auth method selected」で失敗します。GOOGLE_API_KEY が設定されている場合は、unset GOOGLE_API_KEY で削除してください。

手順 3: Gemini のモデル名を無料モデルに対応付ける

Gemini CLI は、gemini-2.5-flash などの Gemini のモデル名を求めます。FreeLLMAPI は、これらの名前を Google に直接送信しません。Keys, Agents タブの Gemini ファミリーの対応付けで解決します。各ファミリー(Pro、Flash、Flash-Lite)を、Auto または固定のカタログモデルに対応付けます。

  • Auto を選ぶと、ルーターはリクエストごとに無料モデルを選択します。1 つのプロバイダーが 429 エラーを返すと、次のプロバイダーを試します。
  • カタログ ID もモデル名として使用できます。gemini -m <catalog-id> で Gemini CLI を起動するか、GEMINI_MODEL を設定します。
  • Gemini CLI はツールを使うエージェントです。ファミリーは、ツール呼び出しとコンテキストウィンドウの大きいモデルに対応付けてください。

1 つ目の表は、本日カタログにある無料の Gemini モデルを示します。2 つ目の表は、Gemini ファミリーに対応付けできるほかの無料モデルを示します。

ツール呼び出しに対応する無料の Gemini API モデル(Google AI Studio)
モデル無料で利用可能コンテキスト無料枠の上限(最良の条件)ツール画像入力
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaはいはい
Gemini Flash (latest alias)Google AI Studio-10 リクエスト/分
20 リクエスト/日
250,000 トークン/分
~3M
はいはい
Gemini 3.7 FlashGoogle AI Studio1M10 リクエスト/分
20 リクエスト/日
250,000 トークン/分
~3M
はいはい
Gemini 3.6 FlashGoogle AI Studio1M10 リクエスト/分
20 リクエスト/日
250,000 トークン/分
~3M
はいはい
Gemini 3.5 FlashGoogle AI Studio1M10 リクエスト/分
20 リクエスト/日
250,000 トークン/分
~3M
はいはい
Gemini 3.8 LiveGoogle AI Studio-10 リクエスト/分
20 リクエスト/日
250,000 トークン/分
~3M
はいはい
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 リクエスト/分
20 リクエスト/日
250,000 トークン/分
~3M
はいはい
Gemini 3.5 Flash LiteGoogle AI Studio1M15 リクエスト/分
20 リクエスト/日
250,000 トークン/分
~3M
はいはい

一致する無料モデル 14 件のうち 8 件を表示しています。 すべてのモデルを見る.

FreeLLMAPI カタログのライブデータ(バージョン 2026.11.19、確認日 2026-11-19)。無料枠の上限は頻繁に変わります。カタログは毎日確認されます。

Gemini CLI 向けのほかの無料モデル: ツール呼び出しとコンテキスト 128K 以上
モデル無料で利用可能コンテキスト無料枠の上限(最良の条件)ツール画像入力
GLM 5.3UnoRouter1M1 リクエスト/分
1 req/min per model
はいいいえ
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 リクエスト/分
40 RPM
はいはい
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceはいいいえ
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditはいはい
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditはいはい
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 リクエスト/分
50 リクエスト/日
50 req/day account-wide (1,000 after a $10 purchase)
はいはい
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 リクエスト/分
50 リクエスト/日
Shared rate limit
はいいいえ
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 リクエスト/分
250 リクエスト/日
70,000 トークン/分
~6M
はいはい

一致する無料モデル 104 件のうち 8 件を表示しています。 すべてのモデルを見る.

FreeLLMAPI カタログのライブデータ(バージョン 2026.11.19、確認日 2026-11-19)。無料枠の上限は頻繁に変わります。カタログは毎日確認されます。

Gemini の無料枠の上限

Google のレート制限ページによると、上限はキーごとではなくプロジェクトごとに適用されます。1 つのプロジェクトでキーを増やしても、クォータは増えません。Google はまた、上限は保証されないこと、現在の上限は Google AI Studio で確認できることも述べています。プレビューモデルの上限は低くなっています。

無料の Gemini Flash キーで送信できるリクエストは、1 日あたり少数です。Gemini CLI の 1 つのタスクで、多数のリクエストが送信されることがあります。ほかのプロバイダーのキーを追加すると、Gemini のクォータが尽きた場合でも、ルーターが処理を続けられます。ネイティブのサーフェスは、generateContent、streamGenerateContent(?alt=sse 付き)、countTokens、およびモデル一覧に対応します。

FreeLLMAPI は、キーを x-goog-api-key ヘッダー、Bearer トークン、または Gemini の ?key= クエリパラメーターで受け付けます。URL のキーはシェルの履歴やプロキシのログに残る可能性があるため、ヘッダーを優先してください。

トラブルシューティング

問題原因対処
Gemini CLI で Google のログイン画面が開く認証の種類が Gemini API key に設定されていないUse Gemini API key を選択するか、security.auth.selectedType を設定する
「Invalid auth method selected」カスタムのベース URL と一緒に GOOGLE_API_KEY を使用しているGEMINI_API_KEY を使用し、GOOGLE_API_KEY を unset する
リクエストがゲートウェイではなく Google に送信されるこのシェルで GOOGLE_GEMINI_BASE_URL が設定されていない変数をエクスポートしてから、gemini を再度起動する
モデルの呼び出しで 404ベース URL に /v1beta が含まれているオリジンの http://localhost:3001 のみを使用する
ツール呼び出しが失敗するGemini ファミリーが、ツール呼び出しの性能が低いモデルに対応付けられているファミリーを、上の表のモデルに対応付ける
「All models rate-limited after N attempts」すべてのキーが上限に達しているより多くのプロバイダーのキーを追加するか、クールダウンの終了を待つ
これらすべてを 1 つのキーで利用できます。 FreeLLMAPI は、オープンソースのセルフホスト型ルーターです。これらの無料枠すべてを 1 つの OpenAI 互換エンドポイントの背後にまとめ、レート制限に達した場合は自動的に別のプロバイダーへ切り替えます。 カタログを見る または 公開.

よくある質問

Gemini CLI は今も無料ですか?

Google は 2026 年 6 月 18 日に、無料利用者と Google One のユーザーに対する Google ログインによる Gemini CLI の無料利用を終了しました。CLI は今もカスタムのベース URL に対応しているため、FreeLLMAPI などの無料ゲートウェイで実行できます。

カスタムエンドポイントで Gemini CLI を使うには?

GOOGLE_GEMINI_BASE_URL にエンドポイントのオリジンを、GEMINI_API_KEY にそのキーを設定してから、Use Gemini API key を選択します。エンドポイントは、/v1beta でネイティブの Gemini API に対応している必要があります。

Gemini CLI で Gemini 以外のモデルを使えますか?

はい。FreeLLMAPI を使うとできます。ゲートウェイは、Gemini の Pro、Flash、Flash-Lite のファミリー名を、Auto または任意のカタログモデルに対応付けます。例えば、Qwen や GLM のモデルです。

Gemini API の無料枠の上限はいくつですか?

Google は上限をキーごとではなくプロジェクトごとに設定し、現在の値を Google AI Studio に表示します。このページの表は、FreeLLMAPI カタログから得た、本日の無料 Gemini モデルとその上限を示します。

「Invalid auth method selected」と表示されるのはなぜですか?

Gemini CLI の問題報告によると、GOOGLE_API_KEY を GOOGLE_GEMINI_BASE_URL と一緒に使うと、バージョン 0.44.x でこのエラーが発生します。GEMINI_API_KEY を使用し、GOOGLE_API_KEY を unset してください。

関連ガイド

出典

すべてのガイド · 無料モデルをすべて見る