メインコンテンツへスキップ
GET
キャッシュを取得
BaseURL:デフォルトの BaseURL は https://direct.evolink.ai で、テキストモデルへの対応が優れており、長時間接続をサポートします。https://api.evolink.ai はマルチモーダルの主力エンドポイントで、テキストモデルに対しては代替アドレスとして使用されます。
{id} は作成時に返される name から cachedContents/ プレフィックスを除いた部分です。メタデータのみを返し、キャッシュ内容は返しません。無料です。

承認

Authorization
string
header
必須

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

API Key の取得:

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

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

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

パスパラメータ

id
string
必須

キャッシュID:作成時の name から cachedContents/ を除いた部分です。cachedContents/20261103012026348092000s1oTuB96 なら 20261103012026348092000s1oTuB96 を指定します。

例:

"20261103012026348092000s1oTuB96"

レスポンス

キャッシュのメタデータ

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