프롬프트 캐시 진단 공개 베타
Messages 요청에서 프롬프트 캐시 미스 원인을 확인하는 cache diagnostics가 공개 베타로 추가됐습니다.
교안에 영향
이전에는 없던 cache-diagnosis-2026-04-07 베타 헤더 안내가 추가되어, 옛 요청 예시만 보면 동작 안내가 부족합니다.
요약
- Messages 요청에 diagnostics.previous_message_id를 넣으면 API가 이전 턴과의 프롬프트 캐시 접두어 차이를 설명하는 cache_miss_reason를 반환합니다. - cache diagnostics 기능을 쓰려면 cache-diagnosis-2026-04-07 베타 헤더를 요청에 포함해야 합니다. - 프롬프트 캐시가 어디서 어긋났는지 진단할 수 있는 기능이 공개 베타로 제공됩니다.
바뀐 것
새 기능
- cache diagnostics가 공개 베타로 추가되었습니다.
- Messages 요청에 diagnostics.previous_message_id를 넣으면 cache_miss_reason으로 캐시 미스 원인을 확인할 수 있습니다.
- cache-diagnosis-2026-04-07 베타 헤더를 요청에 포함해야 합니다.