Zum Hauptinhalt springen
POST
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.
Explizites Kontext-Caching: Erstellen Sie aus einem wiederverwendeten langen Präfix (lange Dokumente, Systemanweisungen, Tool-Definitionen) einen Cache; spätere Generierungsanfragen senden nur den Cache-Namen und die neue Frage. Gecachte Token werden zum Cache-Treffer-Preis abgerechnet. Zusätzlich fallen eine Cache-Schreibgebühr und eine stündliche Speichergebühr an; die Speichergebühr wird bei Erstellung für die gesamte Gültigkeitsdauer berechnet und nicht erstattet.
Cache verwenden: Fügen Sie dem Request-Body von generateContent oder streamGenerateContent "cachedContent": "<name>" hinzu und geben Sie in contents nur die neue Frage an. Anfragen mit Cache dürfen kein systemInstruction, tools oder toolConfig enthalten und müssen dasselbe Modell wie der Cache verwenden.

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.

Body

application/json
model
string
erforderlich

Modell; sowohl models/gemini-3.8-flash als auch gemini-3.8-flash sind zulässig. Unterstützt: gemini-3.8-flash, gemini-3.7-flash, gemini-3.6-flash, gemini-3.5-flash, gemini-3.5-flash-lite, gemini-3-flash-preview, gemini-3.1-flash-lite-preview, gemini-3.1-pro-preview, gemini-3.1-pro-preview-customtools, gemini-3-pro-preview

Beispiel:

"models/gemini-3.8-flash"

contents
object[]

Zu cachender Gesprächsinhalt als Array. Er wird beim Verweis auf den Cache zum Gesprächspräfix. Mindestens eines von contents, systemInstruction oder tools angeben

systemInstruction
object

Systemanweisungen. Nach dem Cachen darf systemInstruction nicht erneut in Generierungsanfragen mit diesem Cache enthalten sein

tools
object[]

Tool-Deklarationen. Nach dem Cachen darf tools nicht erneut in Generierungsanfragen mit diesem Cache enthalten sein

toolConfig
object

Tool-Aufrufkonfiguration (z. B. functionCallingConfig). Nach dem Cachen darf toolConfig nicht erneut in Generierungsanfragen mit diesem Cache enthalten sein

ttl
string

Gültigkeitsdauer, z. B. "3600s". Minimum 60s, Maximum 604800s (168 Stunden). Entweder dies oder expireTime; beide führen zu 400. Ohne beide gilt 3600s

Beispiel:

"3600s"

expireTime
string<date-time>

Absoluter Ablaufzeitpunkt (RFC 3339, UTC), alternativ zu ttl; beide zusammen führen zu 400

Beispiel:

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

displayName
string

Name zur eigenen Orientierung, maximal 255 Zeichen; ohne Einfluss auf die Abrechnung

Maximum string length: 255
Beispiel:

"product-manual-v3"

Antwort

Cache erstellt. usageMetadata.totalTokenCount ist die Anzahl gecachter Tokens für die Berechnung der Schreib- und Speichergebühren

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