概述
ARouter 同時支援平台點數與自帶供應商金鑰(BYOK)兩種模式。使用自帶金鑰時,請求會透過您的供應商帳戶路由,同時保留 ARouter 的所有功能 — 統一 API、故障轉移、數據分析與花費控管。 您的供應商金鑰會安全加密儲存,並自動優先用於路由。無需更改任何程式碼 — 只要在控制台新增金鑰,您現有的 ARouter API Key 即可如常運作。運作方式
- 在 設定 → 整合 中新增您的供應商 API 金鑰。
- ARouter 會自動使用您的金鑰存取該供應商。
- 若您的金鑰無法使用,ARouter 可退回平台金鑰(可設定)。
- 用量分開追蹤:BYOK 與平台各自獨立。
支援的供應商
ARouter 支援以下憑證類型的 BYOK:新增 BYOK 金鑰
控制台操作
- 前往 設定 → 整合。
- 點選 新增供應商金鑰。
- 選擇供應商與憑證類型。
- 輸入您的金鑰或憑證。 5.(選填)點選 測試金鑰 確認金鑰有效。
- 點選 儲存。
進階選項
新增金鑰時,您可以設定:退回行為
預設情況下,當您的 BYOK 金鑰遇到速率限制或錯誤時,ARouter 會無縫退回平台金鑰。您可以針對每組金鑰調整此行為:
在控制台啟用 「一律使用此金鑰」 即可設定為拒絕退回。
多組金鑰
您可以為同一供應商新增多組 BYOK 金鑰。ARouter 會在所有可用金鑰之間使用加權隨機選擇。透過 權重 欄位來控制流量分配。BYOK 用量追蹤
BYOK 請求會在用量儀表板中獨立追蹤:- BYOK 請求數 — 使用您金鑰的請求次數
- 預估 BYOK 花費 — 根據供應商定價估算的費用
- 平台花費 — 使用平台金鑰的請求費用
Azure 設定
Azure OpenAI 請以 JSON 格式提供金鑰設定:AWS Bedrock 設定
AWS Bedrock 請提供您的 AWS 憑證:Google Vertex AI 設定
Vertex AI 請提供您的服務帳戶憑證:排除 BYOK 問題
如果 BYOK 請求失敗:- 前往 設定 → 整合,檢查金鑰健康狀態。
- 點選金鑰以查看最近的錯誤訊息。
- 使用 測試金鑰 按鈕確認金鑰仍然有效。
- 在 用量 頁面查看 BYOK 專屬的錯誤率。