API 供應商掛了怎麼辦：30 分鐘應急遷移清單

第 0 步：先判斷掛的是誰（2 分鐘）

切換之前先花兩分鐘確認故障源，避免白忙：

檢查	結論
查 status.anthropic.com 是否有事故	官方掛了 → 換渠道也沒用，等恢復
用另一家渠道（或官方賬號）發同一請求	別家正常 → 是你的渠道掛了，開始遷移
檢查自己的網絡/代理	本地問題 → 不要錯怪渠道

第 1 步：止損（5 分鐘）

1. 暫停批任務——正在跑的 AutoLabeling/合成管線先停，避免大量失敗請求污染結果集
2. 截圖餘額——渠道後臺的餘額頁面、充值記錄立即截圖存證，這是事後追討退款的依據
3. 導出用量日誌——如果後臺還能訪問，把逐請求日誌導出來

第 2 步：切換到備用渠道（10 分鐘）

所有 Anthropic 兼容工具的切換都只涉及兩個值：Base URL 和 API Key。常用工具的位置：

工具	改哪裏
Claude Code	環境變量 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY，改完重啓終端
Cursor	Settings → Models → API Key 區域，替換 Base URL 和 Key
SDK（Python/TS）	客戶端初始化的 base_url 和 api_key 參數，通常在配置文件/環境變量
New API / one-api 網關	後臺渠道管理：把故障渠道權重設 0，啓用備用渠道——業務端零改動

注意：不同渠道的模型命名可能不同（如 claude-opus-5 與帶日期後綴的版本），切換時對照新渠道的模型列表改 model 參數。

第 3 步：驗證新渠道（15 分鐘）

應急時最容易踩的坑：慌不擇路換into另一個假模型渠道，數據污染的損失比停機更大。三個檢查跑完再恢復批任務：

1. 查 model 字段——響應裏的 model 必須與請求一致
2. temperature=0 對比——同一道複雜題對比官方 api.anthropic.com 的輸出（詳見驗真方法）
3. 錨點樣本——拿 50 條已知標準答案的樣本跑一遍，錯誤率正常再放量

第 4 步：事後（當天內）

1. 追討餘額——憑截圖和充值記錄按渠道的退款條款申請退款；沒有書面退款條款的渠道，這筆學費記進供應商評估標準
2. 建立雙供應商冗餘——在網關層（New API/one-api）常備一主一備兩條渠道，或在 SDK 層做故障轉移封裝。下次掛掉時，損失從半天變成 60 秒
3. 複盤信號——回想故障前有沒有危險信號：大促、客服變慢、頻繁 429

常見問題

渠道掛了，充值的餘額還能要回來嗎？

取決於該渠道是否有書面退款條款。立即截圖餘額和充值記錄，通過原聯繫方式書面申請。這也是選供應商時要把「餘量可退寫入條款」作爲硬性標準的原因。

應急切換後，臨時渠道要不要驗真？

必須驗。應急時換into假模型渠道，污染的批數據返工成本遠超停機損失。model 字段 + temperature=0 對比 + 50 條錨點樣本，15 分鐘可完成。

怎麼避免下次再手忙腳亂？

兩層防禦：網關層（New API/one-api）常備主備雙渠道，一鍵切權重；重要管線在代碼層加故障轉移封裝，429/5xx/超時自動切換並告警。