コンテキストのキャッシュ保存

一般的な AI ワークフローでは、同じ入力トークンをモデルに繰り返し渡すことがあります。Gemini API は、パフォーマンスと費用を最適化するために暗黙的なキャッシュ保存を提供します。

暗黙的なキャッシュ保存

Gemini 2.5 以降のすべてのモデルでは、暗黙的キャッシュ保存がデフォルトで有効になっています。ステートフル（previous_interaction_id を使用）とステートレスの両方の会話モードでサポートされています。リクエストがキャッシュにヒットすると、費用削減が自動的に適用されます。有効にするために必要な操作はありません。次の表に、各モデルのコンテキスト キャッシュ保存の最小入力トークン数を示します。

暗黙的なキャッシュ ヒットの可能性を高めるには:

• 大規模で一般的なコンテンツは、プロンプトの先頭に配置します。
• 類似した接頭辞を含むリクエストを短時間で送信しようとする

キャッシュ ヒットしたトークンの数は、レスポンス オブジェクトの usage.total_cached_tokens（Python と JavaScript）フィールドで確認できます。