Passer au contenu principal
POST
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.
Cache explicite du contexte : créez un cache à partir d’un long préfixe réutilisé (documents longs, instructions système, définitions d’outils) ; les requêtes de génération suivantes n’envoient que le nom du cache et la nouvelle question. Les tokens en cache sont facturés au tarif de lecture du cache. S’y ajoutent des frais d’écriture et un stockage facturé à l’heure ; le stockage est facturé à la création pour toute la durée et n’est pas remboursé.
Utiliser un cache : ajoutez "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

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.

Corps

application/json
model
string
requis

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

Exemple:

"models/gemini-3.8-flash"

contents
object[]

Contenu de conversation à mettre en cache, obligatoirement un tableau. Il devient le préfixe lors de l’utilisation du cache. Fournissez au moins un des champs contents, systemInstruction ou tools

systemInstruction
object

Instructions système. Une fois mises en cache, systemInstruction ne doit plus figurer dans les requêtes de génération utilisant ce cache

tools
object[]

Déclarations d’outils. Une fois mises en cache, tools ne doit plus figurer dans les requêtes de génération utilisant ce cache

toolConfig
object

Configuration des appels d’outils (par exemple functionCallingConfig). Une fois mise en cache, toolConfig ne doit plus figurer dans les requêtes de génération utilisant ce cache

ttl
string

Durée, par exemple "3600s". Minimum 60s, maximum 604800s (168 heures). Mutuellement exclusif avec expireTime ; les deux renvoient 400. Sans les deux, valeur par défaut 3600s

Exemple:

"3600s"

expireTime
string<date-time>

Expiration absolue (RFC 3339, UTC), mutuellement exclusive avec ttl ; les deux renvoient 400

Exemple:

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

displayName
string

Nom pour votre usage, 255 caractères maximum ; sans effet sur la facturation

Maximum string length: 255
Exemple:

"product-manual-v3"

Réponse

Cache créé. usageMetadata.totalTokenCount est le nombre de tokens utilisé pour calculer les frais d’écriture et de stockage

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