spb/doc-api

1#!/usr/bin/env python32# STATUS: LIVE_VERIFIED — executed 2026-09-18 (exit 0 in 0.6s) — ACCOUNT_RESTRICTED path taken (free tier)3# Explicit caching lifecycle: create (~5k tokens, ttl 120s) -> generateContent with cachedContent -> get -> patch ttl -> delete. On the free tier creation fails with 429 TotalCachedContentStorageTokensPerModelFreeTier limit=0 (ACCOUNT_RESTRICTED) and the script exits 0 after printing the error.4# Run: .venv/bin/python examples/gemini/context-caching/cache_lifecycle.py   (GEMINI_API_KEY read from .env via scripts.live; google-genai 2.24)5import pathlib6import sys78ROOT = pathlib.Path(__file__).resolve().parents[3]9sys.path.insert(0, str(ROOT))10from scripts import live  # noqa: E402  loads .env, provides log_request1112from google import genai  # noqa: E40213from google.genai import types  # noqa: E402,F4011415client = genai.Client()16MODEL = "gemini-3.5-flash"17from google.genai import errors  # noqa: E4021819filler = " ".join(f"Section {i}: The Atlas reference corpus documents the public API surface of large language model providers, including endpoints, parameters, streaming events, objects, errors and pricing, verified experimentally." for i in range(1, 121))20try:21    cache = client.caches.create(model=MODEL, config=types.CreateCachedContentConfig(display_name="atlas-example", ttl="120s", system_instruction="Answer with one word.", contents=[filler]))22except errors.ClientError as e:23    live.log_request("gemini", "POST", "/v1beta/cachedContents", e.code, 0.0, "example context-caching/cache_lifecycle.py create (restricted)")24    print("ACCOUNT_RESTRICTED:", e.code, str(e)[:200])25    sys.exit(0)26live.log_request("gemini", "POST", "/v1beta/cachedContents", 200, 0.0015, "example context-caching/cache_lifecycle.py create")27print(cache.name, cache.expire_time, cache.usage_metadata)28r = client.models.generate_content(model=MODEL, contents="Reply with OK.", config=types.GenerateContentConfig(cached_content=cache.name, max_output_tokens=8))29live.log_request("gemini", "POST", "/v1beta/models/{model}:generateContent", 200, 0.0001, "example cache use")30print(r.text, r.usage_metadata.cached_content_token_count, r.usage_metadata.prompt_token_count)31print(client.caches.get(name=cache.name).expire_time)32print(client.caches.update(name=cache.name, config=types.UpdateCachedContentConfig(ttl="300s")).expire_time)33client.caches.delete(name=cache.name)34live.log_request("gemini", "DELETE", "/v1beta/cachedContents/{id}", 200, 0, "example cache delete")35print("deleted")36