ChatGPT Claude Gemini API金鑰錯誤與存取受限的排查清單

後台接了ChatGPT、Claude、Gemini的API，最常見的翻車不是模型不行，而是API金鑰錯誤、網路連不上、地區策略卡住。Midjourney雖然不走API金鑰那套，但在Discord裡也會遇到權限和配額提示，本質同一類：你沒「被允許」。

1分鐘自檢 90%的API錯誤都在這裡

• 金鑰貼錯：多複製了空格、換行，或把「專案金鑰」當成「個人金鑰」用
• 金鑰權限不夠：未開通計費/未綁卡/組織或專案沒授權到對應模型
• 環境變數沒生效：服務重啟了嗎？容器裡和本機是不是兩套設定
• 被代理坑了：能打開網頁不代表後端能直連API網域，很多人卡在這裡

按報錯資訊對症下藥

提示 Unauthorized 或 Invalid API key

別急著甩鍋給平台，先去控制台重新生成金鑰，舊的直接廢掉；再檢查請求標頭裡用的是不是正確欄位。做機器人或外掛時，像一些Koishi外掛就經常因為金鑰欄位名或貼上格式導致報錯。

提示 Rate limit 或 Quota exceeded

這不是「壞了」，是你用太猛了。把併發降下來、加重試退避；需要穩定就上更高配額的方案。Midjourney遇到fast用完也是同理，慢速排隊別上火。

提示 Network error 或存取受限

後端伺服器用curl直連測試目標網域；如果公司網路或機房出海不穩，換線路比換模型更有效。Claude和Gemini對地區與風控更敏感，網路環境一亂就容易觸發。

想省事的做法

如果你只想「能用就行」，別在支付、地區、線路上反覆試錯了。可以直接去Titikey看看更省心的開通與使用方案，把時間留給真正的創作和產品。