Gemini の設定

ダッシュボードで API キーを作成し、Gemini チャンネルを選択します。チャンネルは購入済みクォータの消費速度だけを 0.625 倍にし、購入量は変えません。

このチャンネルではクライアントで宣言・実行する関数を使用できます。Google 検索や Google マップなどのホスト型ツールは転送前に HTTP 400 を返します。有効な内容は届き次第配信し、上流が報告した使用量に基づいて課金します。ツール定義を含み得る明示的な cachedContent 参照も使用できません。暗黙的なキャッシュは利用できます。

生成には標準のサービス階層を使用します。料金が設定されていない階層や fileData によるリモートファイルを指定すると HTTP 400 が返ります。本文でもモデルを指定する場合は URL のモデル名と一致させてください。同じキーで countTokens を呼び出すと、テキストとインラインメディアのトークン数を生成枠を消費せずに確認できます。

利用可能なモデルは GET /v1beta/models で確認できます。

API キーと決済元の残高がともに正であれば生成を開始できます。出力やツールの上限は指定どおりに送信し、完了後に実際の使用量を計上します。同時リクエストにより残高がマイナスになる場合があります。

対応モデル

gemini-4-carbon が利用できます。デフォルトは引き続き gemini-3.5-flash で、gemini-3.7-flash と gemini-3.8-flash にも対応しています。AWSQ、CCMAX、Codex のキーでは Gemini モデルを呼び出せません。価格単位は 100 万トークンあたりの USD です。GPT モデルが必要な場合は Codex キーを使用してください。GPT-6.1 Sol と Terra でこの 2 つの GPT-6.1 モデルを比較しています。

Carbon は公式の導入料金に従います。Google は日付のみを示しており、タイムゾーンは指定していません。本サービスは 2026-12-01 00:00 UTC に料金を切り替えます。出力には思考トークンも含みます。

gemini-4-carbon も Gemini チャンネルで利用できます。入力・キャッシュ読み取り・出力の現在の料金は、料金表で Gemini を選択してください。Carbon は 2026-12-01 00:00 UTC より前は設定された通常基本料金の 50%、以降は通常料金で計算します。表には割引とチャンネル係数が反映されています。

Gemini CLI

公式 Gemini CLI インストールガイドでは Node.js 20.0.0 以上が必要です。まずバージョンを確認します。

1
node --version

未インストール、または 20.0.0 未満の場合は、対応バージョンを先にインストールしてください。以下は Gemini CLI 0.67.0 で確認した設定です。同じ手順を使うには、このバージョンをインストールします。

1
npm install -g @google/[email protected]
2
gemini --version

プロジェクトの設定

プロジェクトディレクトリに .gemini/settings.json を作成します。既存ファイルがある場合は各項目を統合し、customOverrides の項目を既存の配列に追加してください。API キーは環境変数で渡し、このファイルには保存しません。

1
{
2
  "security": { "auth": { "selectedType": "gemini-api-key" } },
3
  "model": { "name": "gemini-3.8-flash" },
4
  "modelConfigs": {
5
    "customOverrides": [
6
      {"match": {"model": "base"}, "modelConfig": {"model": "gemini-3.8-flash"}},
7
      {"match": {"model": "gemini-3-pro-preview"}, "modelConfig": {"model": "gemini-3.8-flash"}},
8
      {"match": {"model": "gemini-3-flash-preview"}, "modelConfig": {"model": "gemini-3.8-flash"}},
9
      {"match": {"model": "gemini-3.1-flash-lite"}, "modelConfig": {"model": "gemini-3.8-flash"}},
10
      {"match": {"model": "gemini-2.5-pro"}, "modelConfig": {"model": "gemini-3.8-flash"}},
11
      {"match": {"model": "gemini-2.5-flash"}, "modelConfig": {"model": "gemini-3.8-flash"}},
12
      {"match": {"model": "gemini-2.5-flash-lite"}, "modelConfig": {"model": "gemini-3.8-flash"}}
13
    ]
14
  },
15
  "agents": {
16
    "overrides": {
17
      "codebase_investigator": { "modelConfig": { "model": "gemini-3.8-flash" } }
18
    }
19
  },
20
  "tools": { "exclude": ["google_web_search", "web_fetch"] }
21
}

この設定は API キー認証を使用し、メインの会話、組み込みの補助リクエスト、コンテキスト圧縮、コードベース調査サブエージェントに gemini-3.8-flash を指定します。--model だけではすべての補助モデルやサブエージェントを変更できません。このチャンネルで非対応のホスト型 Google 検索と URL コンテキストのツールは除外します。ローカルファイルと shell のツールは利用できます。

プロジェクトディレクトリから起動

プレースホルダーをダッシュボードで作成した Gemini キーに置き換えます。初回起動時は CLI の案内に従ってプロジェクトを信頼し、プロジェクト設定を読み込んでください。

1
export GEMINI_API_KEY="YOUR_DASHBOARD_API_KEY"
2
export GOOGLE_GEMINI_BASE_URL='https://api.aiinide.com'
3
gemini --model gemini-3.8-flash

モデルの明示指定を維持してください。プロジェクト設定なしで gemini を実行すると、サービスのデフォルトモデルではなくクライアントの Auto ルーティングが使われます。CLI の更新、モデル変更、独自エージェントや拡張機能の追加時には、それらのモデル設定も確認してください。Model "…" is not configured が出た場合は、エラーにあるモデル名と読み込まれた設定を確認します。詳しくは公式のモデル設定とサブエージェント設定を参照してください。

クライアントではダッシュボードのキーだけを使用し、サーバーの upstream GEMINI_API_KEY は使用しないでください。

通常のリクエスト

この例には説明対象のコード全体が含まれており、ローカルファイルは読み込みません。プレースホルダーをダッシュボードで作成した Gemini キーに置き換え、Bash 互換のシェルで実行してください。以下の通常リクエストとストリーミングリクエストは、どちらも実際の使用量に応じてクォータを消費します。

1
export GEMINI_API_KEY="YOUR_DASHBOARD_API_KEY"
2
 
3
curl --globoff --fail-with-body 'https://api.aiinide.com/v1beta/models/gemini-3.8-flash:generateContent' \
4
  -H "x-goog-api-key: $GEMINI_API_KEY" \
5
  -H "Content-Type: application/json" \
6
  -d '{"contents":[{"role":"user","parts":[{"text":"この JavaScript 関数の戻り値を一文で説明してください:function add(a, b) { return a + b; }"}]}]}'

candidates[].content.parts[].text に回答があり、対応する候補の finishReason が "STOP" であることを確認します。例えば「2 つの数値を加算し、どちらかが文字列なら文字列を連結します」という回答です。表現は変わる場合があります。回答がない場合は promptFeedback と finishReason を確認してください。MAX_TOKENS は出力上限への到達を示します。実際の使用量は利用履歴で確認できます。

ストリーミング

上で設定したキーを使用します。generateContent を streamGenerateContent に変更し、?alt=sse と curl -N で届いたチャンクを順次表示します。

1
curl --globoff --fail-with-body -N 'https://api.aiinide.com/v1beta/models/gemini-3.8-flash:streamGenerateContent?alt=sse' \
2
  -H "x-goog-api-key: $GEMINI_API_KEY" \
3
  -H "Content-Type: application/json" \
4
  -d '{"contents":[{"role":"user","parts":[{"text":"この JavaScript 関数の戻り値を一文で説明してください:function add(a, b) { return a + b; }"}]}]}'

レスポンスは SSE の data: イベントです。candidates[].content.parts[].text の回答チャンクを順に読み、候補が finishReason: "STOP" で終了したことを確認してください。同じ関数の説明が得られます。HTTP 200 や最初のテキストだけでは完了を確認できません。切断や別の終了理由があれば内容を確認してください。

Gemini クライアントは Base URL に /v1beta/models/... を追加します。 以前の Base URL の /api/codex と /api/gemini は、これまでと同じキーで引き続き利用できます。

401 はキー、400 はチャンネルまたはモデル、429 は上限、503 は upstream の一時障害を示します。