寫程式對接 ChatGPT、Claude、Gemini 時,最抓狂的不是模型不夠聰明,而是它根本不理你:401、403、429 輪流來。下面這套排查我自己用得最多,基本能把「API 不通」從玄學拉回現實。
一類錯誤 401 無效金鑰或簽名不對
看到invalid_api_key、Unauthorized,先別懷疑人生,八成是複製多了空格、少了前綴,或者把測試環境的 Key 塞進了生產。
- 確認 Key 來自正確平台:OpenAI、Anthropic、Google 不要混用
- 檢查請求標頭:Bearer 格式是否寫對
- 換一個最小請求驗證,別一上來就帶一堆參數
二類錯誤 429 限流或額度沒了
429 看著像網路問題,其實更像「你用太猛了」。
- 控制併發,做指數退避重試
- 核對帳單與配額,Gemini 和 Claude 的專案/組織別選錯
- 長文本能切就切,提示詞用 KISS 原則:簡單點反而更穩
三類錯誤 403 地區或風控攔截
403 很多時候不是你沒權限,是平台覺得你「可疑」。公司內網、機房 IP、頻繁換節點都容易觸發。


