Saltar al contenido principal
POST
BaseURL: La BaseURL predeterminada es https://direct.evolink.ai, que ofrece mejor compatibilidad con modelos de texto y admite conexiones persistentes. https://api.evolink.ai es el endpoint principal para servicios multimodales y actúa como dirección de respaldo para los modelos de texto.
Caché explícita de contexto: cree una caché a partir de un prefijo largo que reutiliza (documentos largos, instrucciones del sistema, definiciones de herramientas); las siguientes solicitudes de generación solo envían el nombre de la caché y la nueva pregunta. Los tokens en caché se cobran a la tarifa de acierto de caché. Además se cobra la escritura en caché y un almacenamiento por hora; el almacenamiento se cobra al crear por toda la vigencia y no se reembolsa.
Usar una caché: añada "cachedContent": "<name>" al cuerpo de la solicitud generateContent o streamGenerateContent y ponga solo la nueva pregunta en contents. Las solicitudes que usan una caché no pueden incluir systemInstruction, tools ni toolConfig, y deben usar el mismo modelo que la caché.

Autorizaciones

Authorization
string
header
requerido

Todos los endpoints requieren autenticación Bearer Token

Obtener una API Key:

Visite Gestión de API Keys.

Añada esta cabecera:

También se acepta el formato nativo de Gemini: cabecera x-goog-api-key: YOUR_API_KEY o parámetro URL ?key=YOUR_API_KEY.

Cuerpo

application/json
model
string
requerido

Modelo; se admite models/gemini-3.8-flash o gemini-3.8-flash. Compatibles: 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

Ejemplo:

"models/gemini-3.8-flash"

contents
object[]

Contenido de conversación que guardar; debe ser un array. Actúa como prefijo al usar la caché. Proporcione al menos uno de contents, systemInstruction o tools

systemInstruction
object

Instrucciones del sistema. Tras guardarlas, no incluya systemInstruction en generaciones que usen esta caché

tools
object[]

Declaraciones de herramientas. Tras guardarlas, no incluya tools en generaciones que usen esta caché

toolConfig
object

Configuración de llamadas a herramientas (como functionCallingConfig). Tras guardarla, no incluya toolConfig en generaciones que usen esta caché

ttl
string

Vigencia, como "3600s". Mínimo 60s, máximo 604800s (168 horas). Excluyente con expireTime; ambos devuelven 400. Si omite los dos, se usa 3600s

Ejemplo:

"3600s"

expireTime
string<date-time>

Caducidad absoluta (RFC 3339, UTC), excluyente con ttl; ambos devuelven 400

Ejemplo:

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

displayName
string

Nombre para su referencia, hasta 255 caracteres; no afecta a la facturación

Maximum string length: 255
Ejemplo:

"product-manual-v3"

Respuesta

Caché creada. usageMetadata.totalTokenCount es el número de tokens usado para calcular escritura y almacenamiento

name
string

Nombre con formato cachedContents/<id>. Úselo en cachedContent de las generaciones; <id> también es el ID de la solicitud de creación

Ejemplo:

"cachedContents/20261103012026348092000s1oTuB96"

model
string

Modelo asociado a la caché; la generación debe usar el mismo

Ejemplo:

"models/gemini-3.8-flash"

displayName
string

Nombre indicado al crear; se omite si no se indicó

createTime
string<date-time>

Fecha de creación (UTC)

updateTime
string<date-time>

Fecha de última actualización (UTC)

expireTime
string<date-time>

Caducidad (UTC); se elimina automáticamente al caducar

usageMetadata
object