跳转到主要内容
PATCH
BaseURL 说明:默认 BaseURL 为 https://direct.evolink.ai,对文本模型支持更好,支持长连接;https://api.evolink.ai 是多模态主力地址,对文本模型作为备用地址使用。
只能修改有效期,请求体传 ttl 或 expireTime 之一。延长按新增时长补收存储费,缩短不退费。

授权

Authorization
string
header
必填

##所有接口均需要使用 Bearer Token 进行认证##

获取 API Key:

访问 API Key 管理页面 获取您的 API Key

使用时在请求头中添加:

也接受 Gemini 原生写法:请求头 x-goog-api-key: YOUR_API_KEY,或 URL 参数 ?key=YOUR_API_KEY。

路径参数

id
string
必填

缓存 id:创建接口返回的 name 去掉 cachedContents/ 前缀后的部分。例如 name 为 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> 同时是创建请求的请求号

示例:

"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