使用限制

为避免因使用方式不当导致缓存失效，需满足显式缓存使用的基础限制： store ：写入缓存的前提是存储已开启，即手动配置 store 为 true 或保持缺省（默认为 true ）。 caching ： 前一轮对话请求开启了缓存写入，当前轮次对话才能写入缓存。 以此类推，当某轮次请求需写入缓存，则需保证所有前置轮次请求的缓存写入状态开启，即前置所有轮次均有 "caching": {"type": "enabled"} 。 前面轮次只要存在 "caching": {"type": "enabled"} ，则不支持使用 json_schema ，但支持使用 json_object 。 注意 在版本切换过程中，缓存暂不可用，使用 Responses API 请求时将无法命中缓存，但会进行存储并产生缓存存储费用；版本切换完成后，可正常命中历史轮次的缓存。具体参见 版本切换 。 instructions ：若想写入缓存， instructions 字段应为空。若在本轮请求里设置了 instructions ，该轮对话不能调用已有缓存，也无法将本轮信息写入缓存。 thinking ：请求中 thinking 字段的赋值应与前一轮保持一致，才可使用缓存或写入缓存。 当第 1 轮设定 "thinking":{"type":"auto"} ，则后续如需使用或写入缓存，均需保持同样赋值。 当第 1 轮未设置 thinking 字段，后续请求如需写入缓存或者调用已有缓存，也需保持不设置 thinking 字段。 tools ：仅在首轮请求时可以设置 tools 字段，后续所有对话将默认携带 tools 字段信息的缓存输入。 不支持在后续轮次对话请求中再次设置 tools 字段，否则会冲突并报错。 若首轮对话信息被删除，则后续所有轮次对话都不再携带 tools 字段信息的缓存输入，也无法再配置 tools 字段。