列出显式缓存

GET/v1/cachedContents

列出当前身份拥有且有权访问的缓存。

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

身份验证

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

查询参数

pageSizeinteger

每页最多返回的缓存数量,范围 1–100,默认 100。实际返回数量可能更少。

pageTokenstring

上一页响应中的 nextPageToken,请原样传入。首页无需提供。

响应

cachedContentsobject[]

当前页可见的缓存元数据。不返回缓存的提示词内容。

cachedContents.namestring

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

cachedContents.modelstring

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

cachedContents.displayNamestring

显示名称(若返回)。

cachedContents.createTimestring

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

cachedContents.updateTimestring

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

cachedContents.expireTimestring

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

cachedContents.usageMetadataobject

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

nextPageTokenstring

下一页令牌;没有更多页面时省略。

请求

Shell
1curl --fail-with-body --get 'https://api.token360.ai/v1/cachedContents' \
2  -H "x-goog-api-key: $TOKEN360_API_KEY" \
3  --data-urlencode 'pageSize=20'
4# Subsequent pages: also pass --data-urlencode "pageToken=$NEXT_PAGE_TOKEN"

响应

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