How-to

MiniMax API 接坑指南:客户端断开仍计费,官方建议 max_retries=0

接 API 有个坑,客户端超时或断开,服务端照样生成并收费,重发就再扣一次,官方建议把 SDK 自动重试关掉(max_retries=0) 完整解读:https://t.co/xCBq5mPDlI

Why we picked it

如果你在接 MiniMax 的 API,这条能帮你省下真金白银:客户端断开服务端照常扣费,重试还会再扣一次。官方方案是 max_retries=0,重试逻辑自己写。做生产接入的人都该看一下这个坑。

接 MiniMax API 存在一个计费陷阱:当客户端超时或主动断开连接时,服务端并不会终止生成任务,依然会正常完成并计费。如果客户端此时自动重试同一个请求,服务端会再次生成并再扣一次费,导致同一请求被重复扣款。

Image · 小互
Body

xiaohu 在解读文章中提到,官方给出的建议是关闭 SDK 的自动重试机制,把 max_retries 参数设为 0,由开发者自己在业务层判断是否需要重发请求。这样可以在客户端断开后先查询或确认结果,再决定是否重新发起调用,避免重复扣费。

对做生产环境接入的开发者来说,这属于上线前必须处理的细节:超时处理、幂等设计和重试策略需要自己兜底,而不是依赖 SDK 默认行为。

Original · 小互

接 API 有个坑,客户端超时或断开,服务端照样生成并收费,重发就再扣一次,官方建议把 SDK 自动重试关掉(max_retries=0) 完整解读:https://t.co/xCBq5mPDlI

接 API 有个坑,客户端超时或断开,服务端照样生成并收费,重发就再扣一次,官方建议把 SDK 自动重试关掉(max_retries=0) 完整解读: xiaohu.ai/article/minima…📊 1 ⚡

Industry Coordinates & Source Verification

This report is categorized under AITOP's "How-to" desk, focusing on China's AI industry and domestic foundation model ecosystem. Within our cross-regional analytical framework, it directly maps to AI developer toolchains, coding agents, and engineering workflows and AI regulation, compliance frameworks, and sovereign compute policy. Key entities and technical topics under continuous tracking include MiniMax, API计费, 提示词工程, SDK重试.

Source attribution: curated from 小互 (@imxiaohu).