ChatGPT Claude Gemini API 金鑰錯誤的 5 個排查點 解決 401 403 429

寫程式接 ChatGPT、Claude、Gemini 介面時，最抓狂的不是業務邏輯，是一上來就給你甩個 401/403/429。別急，這類「API 金鑰錯誤」大多不是真的壞了，而是設定細節在捉弄人。

1 401 invalid_api_key 先懷疑複製方式

我見過最多的翻車：金鑰多複製了空格、少了字首、把測試環境的 key 丟到生產。建議做個「最小重現」，就一行請求，保持簡單（KISS），別在一坨業務裡找針。

2 403 權限不足 多半是專案或模型沒開

Claude 和 Gemini 有時會把權限綁在專案、地區或模型白名單上。確認你選的模型是否對當前 Key 開放，主控台裡有沒有「需要啟用 API/結算帳戶」的提示。

3 429 rate limit 不是你寫爛了 是額度或並發

429 常見兩種：請求太密、配額用完。把重試做成指數退避，順手加個並發上限，立刻好很多。

4 環境變數沒生效 本地能跑 線上全跪

Node/Python 裡最常見就是 ENV 沒注入、容器沒重啟、CI 裡變數名拼錯。可以參考一些相依工具的排錯思路：先確認「key 是否真的被讀到」，再談網路和程式碼。

5 網路與地區限制 403 像鬼打牆

公司代理、雲伺服器出口、地區策略都會讓請求看起來「像沒權限」。排查順序我習慣這樣：

• 同一台機器 curl 直連是否成功
• 切換網路或出口節點再試
• 檢查是否被 WAF/代理改寫 Header

Midjourney 的小差別

Midjourney 主要跑在 Discord 生態裡，不是傳統 API Key 那套；你遇到的多是 Discord 授權、頻道權限或機器人不可用，思路也一樣：用最小步驟重現，先排權限再排網路。

如果你正在折騰訂閱、網路節點、帳號地區這些更「玄學」的問題，建議去 Titikey 看看，很多坑用一套更省心的方案就能繞過去。