メインコンテンツへスキップ
PATCH
BaseURL:デフォルトの BaseURL は https://direct.evolink.ai で、テキストモデルへの対応が優れており、長時間接続をサポートします。https://api.evolink.ai はマルチモーダルの主力エンドポイントで、テキストモデルに対しては代替アドレスとして使用されます。
変更できるのは有効期間のみで、リクエストボディには ttl か expireTime のどちらかを指定します。延長時は追加期間分の保存料金を徴収し、短縮しても返金されません。

承認

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"

ボディ

application/json

ttl と expireTime のどちらか一方のみ必須。他のフィールドは400

ttl
string

現在からの新しい有効期間(例:"7200s")。最短 60s、最長 604800s

例:

"7200s"

expireTime
string<date-time>

新しい絶対有効期限(RFC 3339、UTC)

例:

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

レスポンス

更新後のメタデータ。expireTime が新しい有効期限です

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