Skip to main content
GET
List caches
BaseURL: The default BaseURL is https://direct.evolink.ai, which has better support for text models and long-lived connections. https://api.evolink.ai is the primary endpoint for multimodal services and serves as a fallback address for text models.
Returns only the current account’s unexpired caches, latest expiry first. Free.

Authorizations

Authorization
string
header
required

All endpoints require Bearer Token authentication

Get an API Key:

Visit API Key Management to get your API Key.

Add this request header:

The Gemini native format is also accepted: the x-goog-api-key: YOUR_API_KEY header or the ?key=YOUR_API_KEY URL parameter.

Query Parameters

pageSize
integer
default:50

Items per page. Default 50, maximum 200.

Required range: x <= 200
pageToken
string

The nextPageToken from the previous response; omit for the first page.

Response

Cache list. Includes nextPageToken when another page is available

cachedContents
object[]
nextPageToken
string

Returned when another page is available; pass unchanged as pageToken in the next request