한 장의 그림으로 이해하기

그림 크게 보기 ↗ (새 탭)
모델·API · 판정 관망
그림을 글로 풀면
기간 연장과 내용 변경 구분
Gemini 명시적 캐시의 기간 변경은 저장된 문서 내용 교체와 다릅니다.
- 대상
- Gemini로 반복 문서 질의를 구현하는 개발자
- 무엇이 바뀜
- 캐시 update는 ttl 또는 expire_time 변경을 지원합니다.
- 왜 중요한가
- 원본 수정과 캐시 기간 연장만으로 내용이 교체되지는 않습니다.
- 지금 할 일
- 새 내용으로 캐시를 만들고 요청의 참조를 대조합니다.
- 한계·미확인
- generateContent 명시적 캐시의 개념 비유입니다. API 시험은 없습니다.
- 공식 출처
- ai.google.dev
- 확인일
- 2026-09-25
시계를 바꿔도 책의 표지는 그대로다
가상의 사내 안내서를 고친 뒤 기존 캐시의 유지 기간만 늘렸다고 생각해 봅니다. 새 안내서가 준비됐다는 사실과 요청이 새 안내서를 참조한다는 사실은 다릅니다. 그림에서는 모래시계 옆 책은 동그라미 그대로이고, 세모 책은 별도 보관함에 들어갑니다. 문서 버전과 캐시 참조를 함께 관리하자는 설명입니다.
기간 변경 API가 바꾸는 범위
Gemini generateContent의 공식 캐시 문서는 update에서 ttl 또는 expire_time을 새로 지정할 수 있고 다른 변경은 지원하지 않는다고 설명합니다. 따라서 내용이 달라졌다면 기존 캐시 내용이 교체됐다고 가정하지 않고 새 내용으로 캐시를 만드는 흐름을 검토합니다. 이 설명은 명시적으로 생성·참조하는 캐시에 관한 것으로, Interactions API의 암묵적 캐시에 같은 관리 명령을 적용하는 안내가 아닙니다.
교체 전에 문서와 참조를 짝지어 보기
운영 기록에는 원본 문서 버전, 생성한 캐시 이름, 만료 정보, 실제 요청의 참조를 묶어 남기는 방식을 제안합니다. 새 캐시가 준비되면 작은 확인 질문으로 새 내용을 참조하는지 시험한 뒤 연결을 바꿀 수 있습니다. 기존 캐시의 사용처와 정리 여부도 따로 확인합니다. 이번 글은 API 호출·내용 전환·비용 비교를 실행한 결과가 아니며, 새 캐시가 답변 정확성을 보장한다는 뜻도 아닙니다.
참고 원문: Google Gemini Generate Content API 공식 문서 — Context caching / Update a cache · 원문 게시일 상시 문서(게시일 별도 미표기) · 확인일 2026-09-25
AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.
이 글의 검증 카드
- 자료 버전
- generateContent 명시적 context caching 상시 문서·2026-09-25 확인; ttl/expire_time 변경만 지원. Interactions API의 암묵적 캐시와 구분; SDK 설치·호출 시험 없음
- 확인일
- 2026-09-25
- 검증 상태
- 개발자 주장
- 한계·주의
- generateContent 명시적 캐시의 개념 비유입니다. API 시험은 없습니다.
함께 더 정확하게
질문·오류 제보
그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.
개발에서는 이메일 인증 가입 또는 관리자 발급 계정으로 참여할 수 있습니다. 계정·이용 문의
아직 계정이 없으신가요? 회원가입
공개된 질문·제보
아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.