Skip to Content
ModelosClaudeCaché de prompts

Caché de prompts de Claude

Esta página explica cómo activar la caché de prompts de Claude y confirmar un acierto de caché. Los IDs de modelo y las URL de los endpoints están en el resumen de la familia Claude.

ClaveLa caché de Claude requiere marcar cache_control explícitamente; ninguno de los dos endpoints almacena en caché automáticamente.

Coloque el contenido largo y fijo (system prompt, documentos, definiciones de herramientas) al principio de la petición y marque cache_control en el último bloque de contenido fijo. Cuando el prefijo de las peticiones siguientes sea exactamente idéntico, se producirá un acierto de caché.

claude_cache.py
import os import anthropic client = anthropic.Anthropic(base_url="https://api.ofox.ai/anthropic", api_key=os.environ["OFOX_API_KEY"]) LONG_DOC = open("manual.txt", encoding="utf-8").read() # Un documento fijo bastante largo for question in ["¿De qué trata el capítulo 3?", "Resume los puntos clave del documento."]: message = client.messages.create( model="anthropic/claude-sonnet-4.6", max_tokens=1024, system=[ {"type": "text", "text": "Responde a las preguntas basándote en el siguiente documento."}, {"type": "text", "text": LONG_DOC, "cache_control": {"type": "ephemeral"}}, ], messages=[{"role": "user", "content": question}], ) u = message.usage print("Escritura:", u.cache_creation_input_tokens, "Lectura:", u.cache_read_input_tokens)
ElementoDetalle
Validez5 minutos por defecto; el plazo se reinicia con cada acierto. "cache_control": {"type": "ephemeral", "ttl": "1h"} la amplía a 1 hora
Confirmar un acierto (endpoint nativo)En la primera petición, usage.cache_creation_input_tokens es mayor que 0; en un acierto, usage.cache_read_input_tokens es mayor que 0
Confirmar un acierto (endpoint compatible con OpenAI)En un acierto, usage.prompt_tokens_details.cached_tokens es mayor que 0
Longitud mínimaSi el contenido es demasiado corto, no se almacena en caché y ambos campos valen 0. La longitud mínima almacenable de cada modelo figura en la documentación oficial de Anthropic 
FacturaciónLa escritura y la lectura se facturan al precio de escritura y de lectura de caché, respectivamente; consulte la página del modelo 

Información general sobre la caché: Caché de prompts.

Otros errores: Errores habituales.

Última actualización: