跳转到主要内容
GET
查询单个缓存
BaseURL 说明:默认 BaseURL 为 https://direct.evolink.ai,对文本模型支持更好,支持长连接;https://api.evolink.ai 是多模态主力地址,对文本模型作为备用地址使用。
路径中的 {id} 是创建接口返回的 name 去掉 cachedContents/ 前缀后的部分。只返回元数据,不返回缓存内容。查询免费。

授权

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"

响应

缓存元数据

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