MiniMax M3内置的AutoCache功能,能够在后台自动将先前计算好的KV缓存进行复用,从而显著提升响应速度。简而言之,您无需手动配置任何缓存策略,也不需修改提示词或编写额外代码——只要满足触发条件,模型便会自动完成缓存操作。

要使该功能生效,首先需要确认运行环境配置正确。
确认运行环境已启用AutoCache
打开MiniMax Code客户端,进入设置页面,点击「Agent Runtime」,然后检查「Enable AutoCache」开关是否处于开启状态。该选项默认开启,但如果您之前手动关闭过,或者通过CLI启动时添加了--no-cache参数,则需要手动重新启用。
【必须确保MiniMax Code版本 ≥ v2.3.1】——旧版本不支持动态KV块匹配,会直接跳过缓存判定流程,导致该功能无法生效。
构造可被自动识别的重复请求模式
MiniMax M3的自动缓存并非依据语义相似度进行识别,而是通过请求指纹(Request Fingerprint)实现精确匹配。该指纹由三部分哈希值拼接生成:输入token序列的首尾各32个token、当前system prompt的SHA-256摘要、以及temperature值(注意,仅当temperature=0时才会参与哈希计算)。
因此,要触发缓存机制,核心就是保持这三部分完全一致。例如,连续两次发送“请列出Python中处理CSV的5个常用库”这类请求时,如果system prompt未发生变化,且temperature保持为0,那么第二次响应将直接从本地缓存读取KV状态,跳过prefilling阶段。
需要特别提醒的是,指纹匹配对细微差异极其敏感。即使只多了一个空格、换行符,或者将temperature从0改为0.01,指纹都会完全不同,导致缓存失效。
验证Cache是否生效
如何判断缓存是否被命中?很简单,观察MiniMax Code终端窗口右下角的状态栏图标:它会先显示蓝色旋转箭头,接着变为绿色对勾,最后转为灰色时钟图标——这一完整流程表示本次响应成功复用了缓存KV块。如果全程显示橙色闪电图标,则说明走的是全量计算路径,未命中缓存。
此外,还有两种更精确的验证方式:
方法一:在MiniMax Code Python沙箱中调用cache_info()函数,它会返回类似{"hit": true, "reused_tokens": 1842}的字典,直接显示是否命中以及复用了多少token。
方法二:对比两次相同请求的timing日志。若缓存生效,prefilling耗时将从原来的数百毫秒骤降至10ms以内——这是最直观、最可靠的验证指标。
