常見錯誤與恢復

先記錄 HTTP 狀態碼與請求路徑，再依類別處理。

401 未驗證

Key 遺漏、失效、複製不完整，或驗證標頭不符合目前協定。

重新從金鑰頁複製 Key，移除前後空白，並核對 Bearer、x-api-key 或 x-goog-api-key。

目前 Key、帳戶狀態或模型存取範圍不允許此請求。

確認 Key 仍可用，並在模型與價格頁重新選擇可存取的模型。

Base URL、協定路徑或 HTTP 方法不符，用戶端也可能重複附加 /v1。

對照協定頁檢查完整路徑與方法；Base URL 只填入教學指定層級。

短時間內請求太密集，或目前可用額度不足。

降低並行數，依遞增間隔重試，並在主站確認帳戶狀態。

上游或閘道暫時無法完成請求。

保留請求時間與狀態碼，稍後重試；持續失敗時先用 curl 最小請求排除用戶端設定。

本機網路、代理或長連線在回應完成前中斷。

確認網域可存取；串流請求使用退避重連，非冪等操作不要自動重複提交。

保留發生時間、協定、HTTP 方法、路徑、狀態碼與已遮蔽敏感內容的回應片段。不要附上完整 Key。