1min.AI 兼容接口没有请求去重,断流后的自动重试要单独设计

1min.AI 的 OpenAI-compatible Chat Completions 接口不支持幂等键,重发 POST 可能再次收费。做批量摘要或自动化任务时,应先区分结果不完整、费用已发生和业务尚未完成,再决定是否重试。

来源: docs.1min.ai
2026年11月10日
3 min

把批量摘要接到 1min.AI 时,能用熟悉的 SDK 发出请求,只解决了接入的一部分。真正影响无人值守运行的,是连接中断后系统怎么办。官方兼容接口文档明确说明:没有请求去重或幂等键,重试 POST 会成为一次新生成,并可能再次收费。因此,原有应用里习惯性的自动重试,需要在接入前单独检查。

本文讨论的是 1min.AI 的 OpenAI-compatible Chat Completions 接口,不把这些限制外推到整个平台所有工具,也没有进行实际故障测试。

没收到完整答案,不代表没有产生费用

文档建议客户端把 maxRetries 或 max_retries 设为 0。流式结果若缺少 [DONE],应视为不完整;取消请求也不保证免费,供应商已经报告的用量仍会计费。这些规则意味着,应用需要分别记录“结果是否完整”和“是否可能已经消费额度”,不能用一个失败标记概括两者。

例如,一个每天处理客户材料摘要的后台任务,在收到半段文字后断开。如果工作队列立即重发,同一份材料可能再次生成。随后把第二份完整结果交给同事,并不能消除第一次的潜在费用。这个例子用于说明风险,并非平台发生过的事故记录。

业务去重需要放在自己的任务层

较稳妥的接入评估,是给每份输入建立内部任务编号,记录模型、尝试次数和完成状态,并将不完整结果隔离。下一次处理先查这份任务是否已有可用结果,再决定是否发起新的生成。这种内部记录可以减少业务重复处理,却不会让上游接口获得它没有提供的计费幂等能力。

如果任务确实需要重试,应明确允许的次数与费用预算,并保留 x-request-id 供支持人员排查。该标识用于定位请求,不应冒充去重键。对不能接受重复消费或必须保证一次且仅一次处理的流程,这个边界可能比统一模型入口的便利更重要,需要由应用补充控制或选择更符合要求的服务。

看到流结束,还要检查业务结果

官方文档同时指出,拒绝或截断的输出不保证符合预期结构,处理前要检查 message.refusal 和 finish_reason。因此,收到完整传输只是一个检查点:做结构化摘要,还应验证字段是否齐全;打算执行模型建议的动作,还应在应用中校验参数和权限。不能把可解析的 JSON 自动当作可执行的指令。

上线前,可以用非敏感样例演练完整返回、途中断开、拒绝和截断,检查任务状态是否各有去向,以及错误处理是否会偷偷触发额外请求。这是建议的验收清单,不是已完成的兼容性认证。若这些状态能被清楚记录和控制,统一接口才更适合放进批处理;若只能靠“失败就再试一次”,先保留人工复核比直接扩大自动化更稳妥。

内容说明:本文基于公开资料整理,仅供工具选型参考。产品功能、价格及相关政策可能随时调整,请以官方最新信息为准。

原文出处:docs.1min.ai