ChatGPT Claude Gemini 介面報錯 API 金鑰無效的排查清單與快速修復

做自動化內容、機器人、RAG 時，最常見也最氣人的報錯就是「API 金鑰無效」「401 Unauthorized」。明明剛複製的 Key，怎麼就不認了？我把自己踩過的坑整理成一份通用清單，ChatGPT、Claude、Gemini 這類介面基本都適用；Midjourney 更多是帳號／呼叫方式問題，也能對照思路排查。

先確認你用的是對的 Key 和對的入口

很多「無效」其實是「用錯地方」。例如把測試環境的 Key 丟到線上、把舊 Key 貼進新專案，或者模型廠商選錯（OpenAI 的 Key 拿去調 Claude，當然會炸）。

• 確認 Key 來自對應平台，並且沒有多複製空格、換行
• 檢查請求位址是否走了正確的 API 網域與版本
• 別把前端程式碼裡寫死 Key，外洩後平台可能直接封禁

401 和 403 通常不是你手抖 是權限或地區限制

有些帳號沒開通計費、沒通過驗證、或地區策略限制，會返回 403/401，看起來像 Key 錯了，其實是「你沒資格」。

• 檢查是否已綁定可用的支付方式／帳單狀態正常
• 公司網路、代理、雲伺服器 IP 是否觸發風控
• Gemini 或 Claude 遇到地區限制時，換合規網路環境更有效

429 限流別硬剛 先把呼叫姿勢變聰明

429 不是壞消息，說明你請求太猛。繼續狂點只會更慢。

• 加重試與退避（1s、2s、4s 這種）
• 把並發降下來，批次處理改成佇列
• 能快取就快取，別每次都讓模型重算

聯動工具更穩 比如用 MCP 把介面接規範

如果你在用 Claude 做「工具呼叫」，我建議把常用 API 封成 MCP 服務，像 mcp-gateway 這類方案能減少參數亂傳導致的莫名其妙錯誤，維護也更省心。

如果你卡在訂閱、支付、地區網路這類「技術以外的坑」，建議去 Titikey 看看，往往比反覆試錯更快把問題解決掉。