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": "Vous êtes un assistant de manuel produit. Répondez uniquement à partir du manuel fourni. Si une information manque, répondez « Non mentionné dans le manuel »."
}
]
},
"contents": [
{
"role": "user",
"parts": [
{
"text": "(Insérez ici le manuel produit complet. Le contenu mis en cache doit contenir au moins 4 096 tokens.)"
}
]
}
],
"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 Cache explicite du contexte - Créer un cache
Créez un cache avec au moins un des champs contents, systemInstruction ou tools, et éventuellement toolConfig. L’API renvoie son nom name.
- Modèles :
modelacceptemodels/gemini-3.8-flashougemini-3.8-flash. Modèles pris en charge :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-customtoolsetgemini-3-pro-preview. Gemini 4 ne prend pas en charge le cache explicite. - Durée : fournissez soit
ttl, par exemple"3600s", soitexpireTime(RFC 3339), jamais les deux. Sans aucun des deux, la durée est de 1 heure. Minimum 60 secondes, maximum 168 heures (604800s) ; suppression automatique à expiration. - Taille : corps de requête limité à 10 MB. Le contenu doit atteindre le minimum de tokens requis par le modèle (par exemple 4 096 pour
gemini-3.8-flash), sinon l’API renvoie 400. - Champs : seuls les champs documentés sont acceptés ; les autres renvoient 400.
- tools : seuls
googleSearch,codeExecutionetfunctionDeclarationssont acceptés ; les autres outils renvoient 400. namerenvoyé : formatcachedContents/<id>;<id>est l’identifiant de la requête. Recherchez-le dans la page « Logs » du tableau de bord pour retrouver les frais de création.- Facturation : la création facture les frais d’écriture du cache (au tarif d’entrée) et le stockage (par million de tokens et par heure) pour toute la durée, à l’avance. Lors de l’utilisation d’un cache, les tokens en cache sont facturés au tarif de lecture du cache ; si le cache déclare
googleSearch, chaque recherche est facturée en plus. Réduction de durée, suppression et expiration ne remboursent pas le stockage ; une prolongation facture la durée ajoutée. Tarifs par modèle : Tarifs.
Authentification par Authorization: Bearer ; l’en-tête x-goog-api-key est également accepté.
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": "Vous êtes un assistant de manuel produit. Répondez uniquement à partir du manuel fourni. Si une information manque, répondez « Non mentionné dans le manuel »."
}
]
},
"contents": [
{
"role": "user",
"parts": [
{
"text": "(Insérez ici le manuel produit complet. Le contenu mis en cache doit contenir au moins 4 096 tokens.)"
}
]
}
],
"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, 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."cachedContent": "<name>" au corps de la requête generateContent ou streamGenerateContent et ne mettez que la nouvelle question dans contents. Les requêtes qui utilisent un cache ne peuvent pas inclure systemInstruction, tools ni toolConfig, et doivent utiliser le même modèle que le cache.Autorisations
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 :
Authorization: Bearer YOUR_API_KEY
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.
Corps
Modèle ; models/gemini-3.8-flash et gemini-3.8-flash sont acceptés. Modèles pris en charge : 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"
Réponse
Cache créé. usageMetadata.totalTokenCount est le nombre de tokens utilisé pour calculer les frais d’écriture et de stockage