1min.AI 相容介面沒有請求去重,串流中斷後的自動重試要另外設計

1min.AI 的 OpenAI-compatible Chat Completions 介面不支援冪等鍵,重新傳送 POST 可能再次收費。進行批次摘要或自動化任務時,應先區分結果不完整、費用已產生及業務尚未完成,再決定是否重試。

來源: docs.1min.ai
November 10, 2026
1 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