Gemini API関数呼び出しコスト：Geminiエージェント価格ガイド

12 ステップの関数呼び出しエージェントは、Gemini 3.1 Pro（$2 入力 / $12 出力（1M トークンあたり））で $0.377、Gemini 3.8 Flash（$0.75 / $3.75）で $0.139、Gemini 3.5 Flash Lite（$0.30 / $2.50）で $0.059 かかります。4,000 トークンのシステム指示と関数宣言、1,500 トークンの関数応答、ステップあたり 300 出力トークンを使用します。これらのステップは、各ステップで履歴全体を再送信するため、166,800 入力トークンと 3,600 出力トークンになります。価格は 2026-09-11 日付の当社カタログからのものです。

Gemini 3.8 Flash の 12 ステップの場合：166,800 × $0.75 ÷ 1,000,000 = $0.125 入力、3,600 × $3.75 ÷ 1,000,000 = $0.0135 出力、合計 $0.139。呼び出しごとの関数呼び出し料金はありません。宣言、呼び出し、応答は通常のトークンとして扱われます。Google の組み込みグラウンディングおよび検索ツールは別途料金がかかります（ベンダーページを参照）。

google-genai SDK では、config.tools に Python 関数または FunctionDeclaration オブジェクトを渡します。モデルは function_call パートを返し、それを実行して function_response パートを追加し、完全な contents リストで再度 generate_content を呼び出します。SDK の自動関数呼び出しはそのループを自動で実行しますが、これが最も気づかないうちにコストがかかる方法でもあるため、デフォルトを受け入れるのではなく、AutomaticFunctionCallingConfig の maximum_remote_calls を設定してください。

Gemini 3.8 Flash では入力側が請求額の 90% を占め、Gemini 3.1 Pro では 88% です。3.1 Pro でアシスタントのターンを 2 倍にすると、$0.377 の実行に $0.043 が追加されます。Gemini モデルはデフォルトで推論を行い、推論トークンは出力として請求されます。thinking_config を使用して Flash および Flash Lite ワーカーの思考予算を減らします。キャッシュされたトークンは usage_metadata.cached_content_token_count で報告され、キャッシュが機能していることを確認するために監視するものです。

現在の 3 つの Gemini モデルはすべて、リクエストあたり約 1M トークンを受け入れ、最初のターンにコードベース全体、契約セットやクロールをロードしてエージェントに作業させる誘惑があります。コンテキストウィンドウは容量制限であり、割引ではありません。エージェントはそのコンテキストを各ステップで再送信します。

計算：500,000 トークンのドキュメントを 12 ステップのループで送信するエージェントは、ドキュメントだけで 12 × 500,000 = 6,000,000 入力トークンを送信します。Gemini 3.1 Pro では $2 per 1M で、ツールトラフィックや出力の前に $12.00 per 実行です。Gemini 3.8 Flash では $4.50、3.5 Flash Lite では $1.80。同じタスクを、ステップあたり 5,000 関連トークンを取得する検索エージェントとして行うと、3.1 Pro で約 $0.45 です。

罠には第二の顎があります：レイテンシ。半百万トークン per ステップは、2 分のエージェントを 20 分のものに変えます。1M コンテキストを単一の読み取りパスの上限として扱い、ループの作業メモリとしてではありません。もしドキュメントが本当に毎ステップに存在しなければならない場合、それがコンテキストキャッシュのケースです。

Gemini のコンテキストキャッシュは、大きなプレフィックスを一度アップロードし、キャッシュ名を取得し、各呼び出しでそれを参照できます。キャッシュされた入力トークンは、リスト入力レートの約 25% で請求され、Anthropic や OpenAI の約 10% よりも小さい割引で、さらにトークン時間あたりのストレージ料金がかかりますが、当社のカタログにはありません（ベンダーページを参照）。

500,000 トークンのドキュメントのケースは、1 回のフルプライスイング（$1.00 on 3.1 Pro）で、その後 12 回のキャッシュ読み取りが約 $0.25 ずつで、$1.00 の代わりに約 $4 per 実行で、ストレージを加えます。参照の 12 ステップトレースでシステム指示と関数がキャッシュされた場合、3.1 Pro は約 $0.16 で $0.377 の代わり、3.8 Flash は約 $0.06 で $0.139 の代わりです。

from google import genai
from google.genai import types

client = genai.Client()

def lookup_shipment(tracking_id: str) -> dict:
    """Return the current status for a shipment tracking id."""
    return wms.status(tracking_id)

cache = client.caches.create(
    model="gemini-3.8-flash",
    config=types.CreateCachedContentConfig(
        system_instruction=SYSTEM_PROMPT,
        contents=[types.Content(role="user", parts=[types.Part(text=POLICY_DOCS)])],
        ttl="3600s",
    ),
)
resp = client.models.generate_content(
    model="gemini-3.8-flash",
    contents=history,
    config=types.GenerateContentConfig(
        cached_content=cache.name,
        tools=[lookup_shipment],
        automatic_function_calling=types.AutomaticFunctionCallingConfig(maximum_remote_calls=12),
        max_output_tokens=2000,
    ),
)
m = resp.usage_metadata
# 3.8 Flash: $0.75 in, ~$0.19 cached in, $3.75 out per 1M (+ cache storage, vendor page)
cost = ((m.prompt_token_count - m.cached_content_token_count) * 0.75
        + m.cached_content_token_count * 0.19 + m.candidates_token_count * 3.75) / 1_000_000

割引は 75% しかないため、ストレージ料金が短い実行では消去できます。自分の TTL のために合計を計算してください。プロンプトキャッシュのコスト比較は、3 つのベンダーを並べて表示します。

Gemini のバッチモードは、リクエストを非同期でリストの約 50% で実行し、当社のカタログにはそのレートで Gemini モデルのバッチ行が含まれています（Gemini 3.8 Flash バッチは約 $0.375 / $1.875 per 1M）。ライブループは使用できません。ステップ 2 はステップ 1 の関数応答を必要とするためですが、エージェントの周りのファンアウトは使用できます。エージェントが難しいものを処理する前に 20,000 のサポートメールを分類するなど。リストでは、5 ステップの Gemini 3.8 Flash エージェントはアイテムあたり $0.034 で、20,000 アイテムで $680 です。バッチでは約 $340。LLM バッチ API の価格設定を参照して、ベンダー間の比較を参照してください。

Gemini APIの無料ティアは、エージェントのプロトタイピングに最も安価な場所です。$0で、有料ティアと同じモデルと関数呼び出しサーフェスを提供し、少数のツールでループを反復するのに十分なレート制限があります。2つの注意点：30ステップのループはそれらの制限に達します。また、無料ティアのデータ使用条件は有料ティアと異なるため、エージェントが実際のデータに触れる前に従量課金制に移行してください。

コンシューマープランであるGoogle AI Plus（$4.99）、Google AI Pro（$19.99）、Google AI Ultra（月額$99.99から、20倍ティアは$199.99）はAPIプランではありません。Googleのプランページでは、AI PlusにはFlashモデルのみがリストされ、ProモデルはAI Proから始まります。これらはGeminiアプリ、Gemini in Workspace、追加ストレージ（400 GB、5 TB、20 TB以上）、およびGoogle独自のコーディングツールの上限引き上げを購入するもので、API請求にはクレジットされません。したがって、この比較は人間が対話的にエージェントを操作する場合にのみ有効です。

チャット、ドキュメント、およびある程度のコーディング支援にGeminiを利用したい個人は、AI Proを購入すべきです。$99.99のUltraは、対話的な使用が月に約265回のキャッシュなしProクラス実行（$99.99 ÷ $0.377）に相当する場合にのみ意味があります。同じ$99.99をAPIで使うと、約1,650回のキャッシュされたGemini 3.8 Flash実行（$99.99 ÷ 約$0.06）が購入できます。Geminiの料金ページにプランの詳細があります。

これを確実に実行できる最も安価なモデル：Gemini 3.8 Flash。12ステップ実行あたり$0.139で、関数宣言に一貫して従い、1Mコンテキストを処理し、キャッシュをサポートし、ルーチンタスクを3.1 Proとほぼ同じステップ数で完了します。これはGoogleスタック上のワーカーエージェントのデフォルトであり、同じトレースでGPT-5.4 mini（$0.141）と同等で、従来のClaude Haiku 4.5（$0.185）よりも安価です。10月に$0.10/$0.50でリリースされたClaude Haiku 5.5は、現在そのトレースを約$0.0185で実行するため、Flashはもはやベンダー間での安価な選択肢ではありません。

Gemini 3.5 Flash Lite（$0.059）は、分類とルーティングのステップや小さなツールセットに適していますが、オープンエンドなタスクではステップ数が増加し、30のFlash Liteステップ（$0.293）は12のFlashステップよりもコストがかかります。プランナーの役割には使用しないでください。

Gemini 3.1 Proに支払うべきタイミング：実行あたり$0.377でFlashの2.7倍のコストであるため、実質的に失敗が少ないか、ステップ数が大幅に少ない必要があります。これは、複数ドキュメントの推論、大規模なツールセットにわたる計画、および誤った関数呼び出しが副作用を持つあらゆる場合に当てはまります。Flashワーカーに委任するプランナーとしては価値がありますが、単純なループのすべてのステップには価値がありません。エージェント向け最安LLMガイドでは、これら3つを他の27モデルと比較しています。

それぞれ異なる障害を捕捉する 4 つの制御方法:

• max_output_tokens in GenerateContentConfig: 関数呼び出しターンでは 1,000 〜 4,000。思考予算と組み合わせて、推論トークンも制限します。
• maximum_remote_calls on AutomaticFunctionCallingConfig、または手動のステップカウンター: ほとんどのタスクでは 12 〜 15。
• 停止条件: 必須の finish 関数、同一の関数呼び出しが 2 回続いた場合の中断、およびステップあたりのコンテキストトークン上限（例: 60,000）を設定し、古い関数レスポンスを強制的に破棄します。
• 実行ごとの USD 予算を、各呼び出し後の usage_metadata から計算します。キャッシュされたトークンはリスト価格のおよそ 25% です。上限を超えたら中断し、タスクごとに記録して、タスク成功あたりのコストを計算します。

Gemini 3.8 Flash のレートでは、実行あたり $0.25 の予算で、キャッシュなし参照ステップ約 17 回、またはキャッシュあり約 40 回が可能です。3.1 Pro では、同じ予算でキャッシュなし約 9 ステップです。AI コスト計算ツールは月間実行回数を予算に変換します。Gemini 101 チュートリアルは SDK の基本を、Claude agent API コストと OpenAI Agents SDK コストのガイドは他のスタックをカバーしています。