Google 本来の形式で使える、リアルタイム料金の Gemini API

1. キーを作成する

   サインアップして $5 からクレジットをチャージし、API キーでキーを作成します。無人で動かすキーには利用上限を設定してください。

2. Gen AI SDK の接続先を Lovely Router にする

   SDK のベース URL に https://lovelyrouter.com を渡します。キーは SDK が送る x-goog-api-key に入れます。?key= や Authorization: Bearer でも使えます。

3. generateContent を呼び出す

   generateContent、streamGenerateContent、countTokens は Google のドキュメントどおりに動作します。

   cURLPythonNode.js

   Shell

   curl "https://lovelyrouter.com/v1beta/models/gemini-3.1-pro:generateContent" \
     -H "x-goog-api-key: $LOVELY_API_KEY" \
     -H "content-type: application/json" \
     -d '{
       "contents": [{"role": "user", "parts": [{"text": "Explain DNS in two sentences."}]}]
     }'

料金は 100 万トークンあたりの米ドル建てで、リアルタイムのカタログから表示しています。ID は GET /v1/models に従い、たとえば gemini-3.1-pro や gemini-3-flash です。gemini-3.1-pro-preview や models/gemini-3-flash のような Google の表記も同じモデルとして扱われます。GET /v1beta/models は、この形式で使えるすべてのモデルを Gemini 本来のレスポンス形式で返します。Gemini モデルは gemini-value チャネルグループで提供しています。現在の提供状況はモデルマーケットプレイスで、チャネルグループごとの 1 時間単位の稼働状況はステータスで確認できます。

次の Gemini エンドポイントは提供していません。cachedContents（明示的なコンテキストキャッシュ）、ファイルのアップロード、embedContent と batchEmbedContents、バッチモード、Live API です。

Gemini モデルは OpenAI Chat Completions と Anthropic Messages にも対応しているため、アプリがどちらかの形式しか扱えない場合に便利です。thinkingConfig などの Gemini 固有のオプションが確実に機能するのは、ネイティブ形式の場合だけです。

Gemini CLI は、エンドポイントとキーを環境変数から読み取ります。

export GOOGLE_GEMINI_BASE_URL=https://lovelyrouter.com
export GEMINI_API_KEY=$LOVELY_API_KEY
gemini -m gemini-3.1-pro

ほかのクライアントについてはお使いのツールで使うを、同じキーで Gemini CLI を Claude Code や Codex CLI と並べて使う方法は AI コーディングエージェントを参照してください。

Gemini は、繰り返し使われるプロンプトのプレフィックスを自動でキャッシュします。マークを付ける必要はありません。キャッシュされたトークンは usageMetadata.cachedContentTokenCount に表示され、キャッシュ読み取りの価格で課金されます。キャッシュ書き込みの料金はかかりません。

キャッシュが役立つのは、次のターンがキャッシュを持つチャネルに届いた場合だけです。Lovely Router はシステムプロンプトと最初のユーザーメッセージから各会話のフィンガープリントを作り、以降のターンを同じチャネルに送り返します。アプリが古い履歴を書き換えたり要約したりする場合は、代わりに会話ごとに固定の x-session-id ヘッダーを送ってください。システム指示にタイムスタンプを入れると、フィンガープリントと Gemini 自身のキャッシュの両方が無効になるため、最新のユーザーメッセージに入れてください。詳しくはプロンプトキャッシュを参照してください。

本来なら自分で対処する必要がある失敗も、まずゲートウェイが再試行します。あるチャネルで失敗したリクエストは、同じグループ内の別のチャネルで再試行されます（最大 3 回まで試行）。ストリームは最初のトークンが届くまで保留されるため、それより前の失敗はクライアントに届かず再試行されます。それでも残ったエラーは Gemini のエラー形式で返されます。429 は RESOURCE_EXHAUSTED、502 は UNAVAILABLE です。これらはバックオフを付けて再試行し、retry-after があればそれに従ってください。不正なリクエスト（400、404、413、422）は、別の場所でも同じように失敗するため再試行されません。

alt=sse の使用をおすすめします。指定しない場合、streamGenerateContent は 1 つの JSON 配列を返します。指定すると、3 分間止まったストリームは検知しやすい DEADLINE_EXCEEDED のエラーイベントで正常に終了します。一覧表はレート制限とフェイルオーバーにあります。

Gemini はトークン単位で課金されます。キャッシュされない入力は promptTokenCount から cachedContentTokenCount を引いた数で、キャッシュされたトークンはキャッシュ読み取りの価格で課金されます。出力は candidatesTokenCount と thoughtsTokenCount の合計で、出力の価格で課金されます。現在はすべてのチャネルグループが定価で課金するため、各 Gemini モデルの料金は Google の定価どおりです。請求額はレスポンスから数秒以内にプリペイド残高から差し引かれます。

サブスクリプションも月額料金もありません。モデルに届く前に拒否されたリクエストは無料で、再試行された試行には課金されず、キャンセルしたストリームは生成された分だけ課金されます。すべてのプロダクトの料金は料金ページにまとめています。