Create cached content (Gemini format)

Creates a cached content entry that can be re-used across subsequent generate-content calls to reduce repeated prefix tokens.

POST /genai/v1beta/cachedContents

Error

A valid request URL is required to generate request examples

200

{}

Authorizations

BearerAuthBasicAuthVirtualKeyAuthApiKeyAuth

Authorization · string · header · required

Bearer token authentication. Use your provider API key or Bifrost authentication token. Virtual keys (prefixed with sk-bf-) can also be passed here.

Headers

x-model-provider · string

Optional provider override. Defaults to gemini. Use vertex to route to Vertex.

Body

application/json

model · string · required

Gemini model identifier (e.g. gemini-1.5-pro). The models/ prefix is stripped.

displayName · string

systemInstruction · object

System instruction content.

contents · any[]

tools · any[]

toolConfig · any

ttl · string

TTL in protobuf duration format (e.g. 3600s).

expireTime · string<date-time>

Response

200

application/json

Successful response

The response is of type object.