Passer au contenu principal
PATCH
BaseURL : La BaseURL par défaut est https://direct.evolink.ai, qui offre une meilleure prise en charge des modèles de texte et des connexions persistantes. https://api.evolink.ai est le point d’accès principal pour les services multimodaux et sert d’adresse de secours pour les modèles de texte.
Seule la durée peut être modifiée : envoyez ttl ou expireTime. Une prolongation facture la durée ajoutée ; une réduction n’est pas remboursée.

Autorisations

Authorization
string
header
requis

Tous les endpoints nécessitent une authentification Bearer Token

Obtenir une clé API :

Consultez la gestion des clés API.

Ajoutez cet en-tête :

Le format natif Gemini est aussi accepté : en-tête x-goog-api-key: YOUR_API_KEY ou paramètre URL ?key=YOUR_API_KEY.

Paramètres de chemin

id
string
requis

Identifiant du cache : le name renvoyé à la création, sans le préfixe cachedContents/. Pour cachedContents/20261103012026348092000s1oTuB96, utilisez ici 20261103012026348092000s1oTuB96.

Exemple:

"20261103012026348092000s1oTuB96"

Corps

application/json

Fournissez exactement un des champs ttl ou expireTime ; les autres champs renvoient 400

ttl
string

Nouvelle durée à partir de maintenant, par exemple "7200s". Minimum 60s, maximum 604800s

Exemple:

"7200s"

expireTime
string<date-time>

Nouvelle expiration absolue (RFC 3339, UTC)

Exemple:

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

Réponse

Métadonnées mises à jour ; expireTime est la nouvelle expiration

name
string

Nom au format cachedContents/<id>. À utiliser dans cachedContent des requêtes de génération ; <id> est aussi l’identifiant de la requête de création

Exemple:

"cachedContents/20261103012026348092000s1oTuB96"

model
string

Modèle lié au cache ; la génération doit utiliser le même modèle

Exemple:

"models/gemini-3.8-flash"

displayName
string

Nom fourni à la création ; absent si aucun nom n’a été fourni

createTime
string<date-time>

Date de création (UTC)

updateTime
string<date-time>

Date de dernière modification (UTC)

expireTime
string<date-time>

Date d’expiration (UTC) ; suppression automatique à expiration

usageMetadata
object