Gemini CLI

Gemini CLI でゲートウェイの API キー認証とネイティブ v1beta API を使います。

導入と準備

  1. Node.js 20 以降を導入し、下の公式 Gemini CLI npm パッケージをインストールします。gemini --version で確認します。
  2. routerra.ai API Keysでキーを作成し、モデルからネイティブ Gemini 対応モデルを選びます。この接続は OpenAI Chat Completions ではなく Gemini の generateContent/streamGenerateContent を使います。
npm install -g @google/gemini-cli
gemini --version

ネイティブ Gemini ルートの設定

  1. Gemini CLI を起動するターミナルで下の 3 変数を設定します。SDK が /v1beta/models/... を追加するため、GOOGLE_GEMINI_BASE_URL は /v1 や /v1beta なしの https://routerra.ai にします。キーとモデルを置き換えます。
  2. 選択画面では Use Gemini API key を選びます。新版はゲートウェイ認証を自動検出する場合があります。既存の Google ログインや Vertex セッションはこの経路を使わない場合があるため、/auth で切り替えます。永続化は ~/.gemini/.env に NAME=value 形式で保存し、再起動します。このファイルをコミットしないでください。
export GEMINI_API_KEY="YOUR_API_KEY"
export GOOGLE_GEMINI_BASE_URL="https://routerra.ai"
export GOOGLE_GENAI_API_VERSION="v1beta"
gemini --model YOUR_GEMINI_MODEL_ID

Windows PowerShell の場合：

$env:GEMINI_API_KEY = "YOUR_API_KEY"
$env:GOOGLE_GEMINI_BASE_URL = "https://routerra.ai"
$env:GOOGLE_GENAI_API_VERSION = "v1beta"
gemini --model YOUR_GEMINI_MODEL_ID

接続を確認

明示的な --model ID で短いプロンプトを試します。Google ログイン画面が出たら認証モードが違います。/v1/v1beta や /v1beta/v1beta へのリクエストは基底 URL に余分なパスがあります。モデルが拒否されたら OpenAI の ID に変えず、ネイティブ Gemini 対応を確認します。競合する GOOGLE_GENAI_USE_VERTEXAI や GOOGLE_GENAI_USE_GCA を除き、再起動して routerra.ai の使用量を確認します。