curl --request POST \
--url https://direct.evolink.ai/v1beta/cachedContents \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "models/gemini-3.8-flash",
"displayName": "product-manual-v3",
"systemInstruction": {
"parts": [
{
"text": "Sie sind ein Assistent für das Produkthandbuch. Antworten Sie nur anhand des bereitgestellten Handbuchs. Fehlt eine Information, antworten Sie „Im Handbuch nicht erwähnt“."
}
]
},
"contents": [
{
"role": "user",
"parts": [
{
"text": "(Hier das vollständige Produkthandbuch einfügen. Der Cache-Inhalt muss mindestens 4.096 Tokens enthalten.)"
}
]
}
],
"ttl": "3600s"
}
'{
"name": "cachedContents/20261103012026348092000s1oTuB96",
"model": "models/gemini-3.8-flash",
"displayName": "product-manual-v3",
"createTime": "2026-11-03T01:20:27.311Z",
"updateTime": "2026-11-03T01:20:27.311Z",
"expireTime": "2026-11-03T02:20:26.902Z",
"usageMetadata": {
"totalTokenCount": 7525
}
}{
"error": {
"code": 400,
"message": "ttl must not exceed 604800s (168h)",
"status": "INVALID_ARGUMENT",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "INVALID_ARGUMENT",
"domain": "evolink.ai"
}
]
}
}{
"error": {
"code": 401,
"message": "Invalid API key",
"status": "UNAUTHENTICATED"
}
}{
"error": {
"code": 402,
"message": "insufficient quota for cache storage prepayment",
"status": "RESOURCE_EXHAUSTED",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "INSUFFICIENT_QUOTA",
"domain": "evolink.ai"
}
]
}
}{
"error": {
"code": 403,
"message": "This key is not allowed to use model gemini-3.8-flash",
"status": "PERMISSION_DENIED"
}
}{
"error": {
"code": 404,
"message": "explicit context caching is not enabled",
"status": "NOT_FOUND",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "EXPLICIT_CACHE_DISABLED",
"domain": "evolink.ai"
}
]
}
}{
"error": {
"code": 413,
"message": "cache content exceeds 10485760 bytes; reference large files with fileData.fileUri instead",
"status": "INVALID_ARGUMENT",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "CACHE_CONTENT_TOO_LARGE",
"domain": "evolink.ai"
}
]
}
}{
"error": {
"code": 429,
"message": "Rate limit exceeded",
"status": "RESOURCE_EXHAUSTED"
}
}{
"error": {
"code": 502,
"message": "the request could not be completed due to a service authorization problem; please retry later or contact support",
"status": "INTERNAL",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "UPSTREAM_ERROR",
"domain": "evolink.ai"
}
]
}
}{
"error": {
"code": 503,
"message": "explicit context caching is temporarily unavailable",
"status": "UNAVAILABLE",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "INTERNAL",
"domain": "evolink.ai"
}
]
}
}Gemini Explizites Kontext-Caching - Cache erstellen
Erstellen Sie einen Cache aus mindestens einem der Felder contents, systemInstruction oder tools, optional mit toolConfig. Zurückgegeben wird der Cache-Name name.
- Modelle:
modelakzeptiertmodels/gemini-3.8-flashodergemini-3.8-flash. Unterstützt werdengemini-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-customtoolsundgemini-3-pro-preview. Gemini 4 unterstützt kein explizites Caching. - Gültigkeitsdauer: Entweder
ttl, z. B."3600s", oderexpireTime(RFC 3339), niemals beide. Ohne Angabe gilt 1 Stunde. Minimum 60 Sekunden, Maximum 168 Stunden (604800s); nach Ablauf automatische Löschung. - Größe: Maximal 10 MB pro Anfrage. Der Inhalt muss die Mindestanzahl an Cache-Tokens des Modells erreichen (z. B. 4.096 für
gemini-3.8-flash), andernfalls folgt 400. - Felder: Nur die dokumentierten Felder werden akzeptiert; andere führen zu 400.
- tools: Nur
googleSearch,codeExecutionundfunctionDeclarationssind zulässig; andere Tools führen zu 400. - Zurückgegebener
name: FormatcachedContents/<id>;<id>ist die Anfrage-ID. Suchen Sie danach auf der Seite „Logs“ im Dashboard, um die Erstellungsgebühr zu finden. - Abrechnung: Bei Erstellung werden die Cache-Schreibgebühr (zum Eingabepreis) und die Speichergebühr (pro Million Token pro Stunde) für die gesamte Gültigkeitsdauer im Voraus berechnet. Bei Verwendung eines Caches werden gecachte Token zum Cache-Treffer-Preis abgerechnet; deklariert der Cache
googleSearch, wird jede Suche separat berechnet. Verkürzung, Löschung oder Ablauf führen zu keiner Erstattung der Speichergebühr; Verlängerungen werden für die zusätzliche Dauer berechnet. Preise je Modell: Preise.
Authentifizierung über Authorization: Bearer; der Header x-goog-api-key wird ebenfalls akzeptiert.
curl --request POST \
--url https://direct.evolink.ai/v1beta/cachedContents \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "models/gemini-3.8-flash",
"displayName": "product-manual-v3",
"systemInstruction": {
"parts": [
{
"text": "Sie sind ein Assistent für das Produkthandbuch. Antworten Sie nur anhand des bereitgestellten Handbuchs. Fehlt eine Information, antworten Sie „Im Handbuch nicht erwähnt“."
}
]
},
"contents": [
{
"role": "user",
"parts": [
{
"text": "(Hier das vollständige Produkthandbuch einfügen. Der Cache-Inhalt muss mindestens 4.096 Tokens enthalten.)"
}
]
}
],
"ttl": "3600s"
}
'{
"name": "cachedContents/20261103012026348092000s1oTuB96",
"model": "models/gemini-3.8-flash",
"displayName": "product-manual-v3",
"createTime": "2026-11-03T01:20:27.311Z",
"updateTime": "2026-11-03T01:20:27.311Z",
"expireTime": "2026-11-03T02:20:26.902Z",
"usageMetadata": {
"totalTokenCount": 7525
}
}{
"error": {
"code": 400,
"message": "ttl must not exceed 604800s (168h)",
"status": "INVALID_ARGUMENT",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "INVALID_ARGUMENT",
"domain": "evolink.ai"
}
]
}
}{
"error": {
"code": 401,
"message": "Invalid API key",
"status": "UNAUTHENTICATED"
}
}{
"error": {
"code": 402,
"message": "insufficient quota for cache storage prepayment",
"status": "RESOURCE_EXHAUSTED",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "INSUFFICIENT_QUOTA",
"domain": "evolink.ai"
}
]
}
}{
"error": {
"code": 403,
"message": "This key is not allowed to use model gemini-3.8-flash",
"status": "PERMISSION_DENIED"
}
}{
"error": {
"code": 404,
"message": "explicit context caching is not enabled",
"status": "NOT_FOUND",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "EXPLICIT_CACHE_DISABLED",
"domain": "evolink.ai"
}
]
}
}{
"error": {
"code": 413,
"message": "cache content exceeds 10485760 bytes; reference large files with fileData.fileUri instead",
"status": "INVALID_ARGUMENT",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "CACHE_CONTENT_TOO_LARGE",
"domain": "evolink.ai"
}
]
}
}{
"error": {
"code": 429,
"message": "Rate limit exceeded",
"status": "RESOURCE_EXHAUSTED"
}
}{
"error": {
"code": 502,
"message": "the request could not be completed due to a service authorization problem; please retry later or contact support",
"status": "INTERNAL",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "UPSTREAM_ERROR",
"domain": "evolink.ai"
}
]
}
}{
"error": {
"code": 503,
"message": "explicit context caching is temporarily unavailable",
"status": "UNAVAILABLE",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "INTERNAL",
"domain": "evolink.ai"
}
]
}
}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.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
Alle Endpunkte erfordern Bearer-Token-Authentifizierung
API-Key erhalten:
Besuchen Sie die API-Key-Verwaltung.
Diesen Anfrageheader hinzufügen:
Authorization: Bearer YOUR_API_KEY
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
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
"models/gemini-3.8-flash"
Antwort
Cache erstellt. usageMetadata.totalTokenCount ist die Anzahl gecachter Tokens für die Berechnung der Schreib- und Speichergebühren