メインコンテンツへスキップ
POST
BaseURL:デフォルトの BaseURL は https://direct.evolink.ai で、テキストモデルへの対応が優れており、長時間接続をサポートします。https://api.evolink.ai はマルチモーダルの主力エンドポイントで、テキストモデルに対しては代替アドレスとして使用されます。
明示的コンテキストキャッシュ:繰り返し使う長いプレフィックス(長文ドキュメント、システム指示、ツール定義)をキャッシュとして作成すると、以降の生成リクエストではキャッシュ名と新しい質問だけを送れます。キャッシュ分はキャッシュヒット単価で課金されます。別途キャッシュ書き込み料金と時間単位の保存料金がかかり、保存料金は作成時に有効期間全体分を徴収し、返金されません。
キャッシュの参照:generateContent または streamGenerateContent のリクエストボディに "cachedContent": "<name>" を追加し、contents には新しい質問だけを入れます。キャッシュを参照するリクエストには systemInstruction・tools・toolConfig を含められず、モデルはキャッシュ作成時と同じである必要があります。

承認

Authorization
string
header
必須

すべてのエンドポイントは Bearer Token 認証が必要です

API Key の取得:

API Key 管理で取得してください。

リクエストヘッダーに追加:

Gemini ネイティブ形式の x-goog-api-key: YOUR_API_KEY ヘッダー、または URL パラメータ ?key=YOUR_API_KEY も使用できます。

ボディ

application/json
model
string
必須

モデル。models/gemini-3.8-flash と gemini-3.8-flash の両形式に対応。対応モデル:gemini-3.8-flash、gemini-3.7-flash、gemini-3.6-flash、gemini-3.5-flash、gemini-3.5-flash-lite、gemini-3-flash-preview、gemini-3.1-flash-lite-preview、gemini-3.1-pro-preview、gemini-3.1-pro-preview-customtools、gemini-3-pro-preview

例:

"models/gemini-3.8-flash"

contents
object[]

キャッシュする会話内容。配列で指定し、参照時の会話プレフィックスになります。contents、systemInstruction、tools のうち少なくとも1つが必要です

systemInstruction
object

システム指示。キャッシュ後は、それを参照する生成リクエストに systemInstruction を指定できません

tools
object[]

ツール宣言。キャッシュ後は、それを参照する生成リクエストに tools を指定できません

toolConfig
object

ツール呼び出し設定(functionCallingConfig など)。キャッシュ後は、それを参照する生成リクエストに toolConfig を指定できません

ttl
string

有効期間(例:"3600s")。最短 60s、最長 604800s(168時間)。expireTime と排他的で、両方指定すると400。両方省略時は 3600s

例:

"3600s"

expireTime
string<date-time>

絶対有効期限(RFC 3339、UTC)。ttl と排他的で、両方指定すると400

例:

"2026-11-03T06:00:00Z"

displayName
string

管理用の名前。最大255文字で、料金には影響しません

Maximum string length: 255
例:

"product-manual-v3"

レスポンス

キャッシュを作成しました。usageMetadata.totalTokenCount が書き込み料金と保存料金の計算に用いるトークン数です

name
string

cachedContents/<id> 形式のキャッシュ名。生成リクエストの cachedContent に指定します。<id> は作成リクエストのIDでもあります

例:

"cachedContents/20261103012026348092000s1oTuB96"

model
string

キャッシュに紐づくモデル。生成時も同じモデルを使用する必要があります

例:

"models/gemini-3.8-flash"

displayName
string

作成時に指定した名前。未指定の場合は返されません

createTime
string<date-time>

作成日時(UTC)

updateTime
string<date-time>

最終更新日時(UTC)

expireTime
string<date-time>

有効期限(UTC)。期限切れ後に自動削除

usageMetadata
object