認證鑑權

網關請求鑑權方式與 API 金鑰安全保管最佳實踐。

建立 API 金鑰

在主控台開啟【API 金鑰】頁面,建立具備足夠額度且擁有目標模型權限的金鑰。將後續範例中的 YOUR_API_KEY 替換為你實際的金鑰。

認證請求頭

請使用網關 API 金鑰,而非上游模型供應商的原始金鑰。在 HTTP 請求的 Authorization 標頭中以 Bearer 格式攜帶。請妥善在伺服端保管金鑰,切勿打包進前端程式碼、公開倉庫或截圖分享中。

Authorization: Bearer YOUR_API_KEY

常見問題排查

若遇認證錯誤,請檢查金鑰正確性與有效期限;若遇額度錯誤,請確認帳戶餘額與金鑰額度;若模型無法使用,請核對模型 ID 與群組權限;若遇速率限制,請採取指數退避重試。