Saltar al contenido principal
GET
Consultar una caché
BaseURL: La BaseURL predeterminada es https://direct.evolink.ai, que ofrece mejor compatibilidad con modelos de texto y admite conexiones persistentes. https://api.evolink.ai es el endpoint principal para servicios multimodales y actúa como dirección de respaldo para los modelos de texto.
{id} es el name devuelto al crear, sin el prefijo cachedContents/. Solo devuelve metadatos, no el contenido de la caché. Gratis.

Autorizaciones

Authorization
string
header
requerido

Todos los endpoints requieren autenticación Bearer Token

Obtener una API Key:

Visite Gestión de API Keys.

Añada esta cabecera:

También se acepta el formato nativo de Gemini: cabecera x-goog-api-key: YOUR_API_KEY o parámetro URL ?key=YOUR_API_KEY.

Parámetros de ruta

id
string
requerido

ID de caché: el name devuelto al crear sin el prefijo cachedContents/. Para cachedContents/20261103012026348092000s1oTuB96, use aquí 20261103012026348092000s1oTuB96.

Ejemplo:

"20261103012026348092000s1oTuB96"

Respuesta

Metadatos de la caché

name
string

Nombre con formato cachedContents/<id>. Úselo en cachedContent de las generaciones; <id> también es el ID de la solicitud de creación

Ejemplo:

"cachedContents/20261103012026348092000s1oTuB96"

model
string

Modelo asociado a la caché; la generación debe usar el mismo

Ejemplo:

"models/gemini-3.8-flash"

displayName
string

Nombre indicado al crear; se omite si no se indicó

createTime
string<date-time>

Fecha de creación (UTC)

updateTime
string<date-time>

Fecha de última actualización (UTC)

expireTime
string<date-time>

Caducidad (UTC); se elimina automáticamente al caducar

usageMetadata
object