获取显式缓存

GET/v1/cachedContents/{id}

获取当前身份拥有的缓存元数据。

/v1 为默认版本,兼容对应的 /v1beta 路径。

身份验证

在 x-goog-api-key 中发送 Token360 API Key。

路径参数

idstringrequired

创建时返回的 name 中的 ID 部分,请原样使用。

响应

namestring

缓存资源名称,格式为 cachedContents/{id}。请保存用于后续操作。

modelstring

模型名称,格式为 models/{model}。

displayNamestring

显示名称(若返回)。

createTimestring

创建时间(RFC3339,若返回)。

updateTimestring

最后更新时间(RFC3339,若返回)。

expireTimestring

到期时间(RFC3339,若返回)。

usageMetadataobject

缓存用量信息(若返回)。

usageMetadata.totalTokenCountinteger

缓存 Token 数量(若返回)。

缓存不存在、已到期或属于其他身份时返回 404。此操作需要缓存对应模型的访问权限。

请求

Shell
1CACHE_NAME='cachedContents/0123456789abcdef0123456789abcdef'
2curl --fail-with-body "https://api.token360.ai/v1/$CACHE_NAME" \
3  -H "x-goog-api-key: $TOKEN360_API_KEY"

响应

JSON
1{
2  "name": "cachedContents/0123456789abcdef0123456789abcdef",
3  "model": "models/gemini-2.5-flash",
4  "displayName": "Reference document",
5  "createTime": "2026-11-06T10:00:00Z",
6  "updateTime": "2026-11-06T10:00:00Z",
7  "expireTime": "2026-11-06T11:00:00Z",
8  "usageMetadata": {
9    "totalTokenCount": 4096
10  }
11}
此页面对您有帮助吗?
获取显式缓存 · Token360