Saltar al contenido principal
PATCH
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.
Solo se puede cambiar la vigencia: envíe ttl o expireTime. Ampliarla cobra el tiempo añadido; reducirla no se reembolsa.

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"

Cuerpo

application/json

Indique exactamente uno de ttl o expireTime; otros campos devuelven 400

ttl
string

Nueva duración desde ahora, como "7200s". Mínimo 60s, máximo 604800s

Ejemplo:

"7200s"

expireTime
string<date-time>

Nueva caducidad absoluta (RFC 3339, UTC)

Ejemplo:

"2026-11-03T06:00:00Z"

Respuesta

Metadatos actualizados; expireTime es la nueva caducidad

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