Zum Hauptinhalt springen
PATCH
BaseURL: Die Standard-BaseURL ist https://direct.evolink.ai und bietet bessere Unterstützung für Textmodelle sowie persistente Verbindungen. https://api.evolink.ai ist der primäre Endpunkt für multimodale Dienste und dient bei Textmodellen als Ausweichadresse.
Nur die Gültigkeitsdauer kann geändert werden: Senden Sie entweder ttl oder expireTime. Eine Verlängerung wird für die zusätzliche Dauer berechnet; eine Verkürzung wird nicht erstattet.

Autorisierungen

Authorization
string
header
erforderlich

Alle Endpunkte erfordern Bearer-Token-Authentifizierung

API-Key erhalten:

Besuchen Sie die API-Key-Verwaltung.

Diesen Anfrageheader hinzufügen:

Auch das native Gemini-Format wird akzeptiert: der Header x-goog-api-key: YOUR_API_KEY oder der URL-Parameter ?key=YOUR_API_KEY.

Pfadparameter

id
string
erforderlich

Cache-ID: der bei Erstellung zurückgegebene name ohne das Präfix cachedContents/. Bei cachedContents/20261103012026348092000s1oTuB96 hier also 20261103012026348092000s1oTuB96 angeben.

Beispiel:

"20261103012026348092000s1oTuB96"

Body

application/json

Genau eines von ttl oder expireTime ist erforderlich; andere Felder führen zu 400

ttl
string

Neue Gültigkeitsdauer ab jetzt, z. B. "7200s". Minimum 60s, Maximum 604800s

Beispiel:

"7200s"

expireTime
string<date-time>

Neuer absoluter Ablaufzeitpunkt (RFC 3339, UTC)

Beispiel:

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

Antwort

Aktualisierte Cache-Metadaten; expireTime ist der neue Ablaufzeitpunkt

name
string

Cache-Name im Format cachedContents/<id>. Im Feld cachedContent der Generierungsanfrage angeben; <id> ist zugleich die ID der Erstellungsanfrage

Beispiel:

"cachedContents/20261103012026348092000s1oTuB96"

model
string

An den Cache gebundenes Modell; Generierungsanfragen müssen dasselbe Modell verwenden

Beispiel:

"models/gemini-3.8-flash"

displayName
string

Bei Erstellung vergebener Name; fehlt, wenn keiner angegeben wurde

createTime
string<date-time>

Erstellungszeit (UTC)

updateTime
string<date-time>

Zeitpunkt der letzten Änderung (UTC)

expireTime
string<date-time>

Ablaufzeitpunkt (UTC); danach automatisch gelöscht

usageMetadata
object