跳轉到主要內容

概述

ARouter 同時支援平台點數與自帶供應商金鑰(BYOK)兩種模式。使用自帶金鑰時,請求會透過您的供應商帳戶路由,同時保留 ARouter 的所有功能 — 統一 API、故障轉移、數據分析與花費控管。 您的供應商金鑰會安全加密儲存,並自動優先用於路由。無需更改任何程式碼 — 只要在控制台新增金鑰,您現有的 ARouter API Key 即可如常運作。

運作方式

  1. 設定 → 整合 中新增您的供應商 API 金鑰。
  2. ARouter 會自動使用您的金鑰存取該供應商。
  3. 若您的金鑰無法使用,ARouter 可退回平台金鑰(可設定)。
  4. 用量分開追蹤:BYOK 與平台各自獨立。

支援的供應商

ARouter 支援以下憑證類型的 BYOK:

新增 BYOK 金鑰

控制台操作

  1. 前往 設定 → 整合
  2. 點選 新增供應商金鑰
  3. 選擇供應商與憑證類型。
  4. 輸入您的金鑰或憑證。 5.(選填)點選 測試金鑰 確認金鑰有效。
  5. 點選 儲存

進階選項

新增金鑰時,您可以設定:

退回行為

預設情況下,當您的 BYOK 金鑰遇到速率限制或錯誤時,ARouter 會無縫退回平台金鑰。您可以針對每組金鑰調整此行為: 在控制台啟用 「一律使用此金鑰」 即可設定為拒絕退回。

多組金鑰

您可以為同一供應商新增多組 BYOK 金鑰。ARouter 會在所有可用金鑰之間使用加權隨機選擇。透過 權重 欄位來控制流量分配。

BYOK 用量追蹤

BYOK 請求會在用量儀表板中獨立追蹤:
  • BYOK 請求數 — 使用您金鑰的請求次數
  • 預估 BYOK 花費 — 根據供應商定價估算的費用
  • 平台花費 — 使用平台金鑰的請求費用
各模型用量表格會顯示 來源 欄位,標示該模型的請求是來自 BYOK、平台,或兩者皆有。

Azure 設定

Azure OpenAI 請以 JSON 格式提供金鑰設定:

AWS Bedrock 設定

AWS Bedrock 請提供您的 AWS 憑證:

Google Vertex AI 設定

Vertex AI 請提供您的服務帳戶憑證:

排除 BYOK 問題

如果 BYOK 請求失敗:
  1. 前往 設定 → 整合,檢查金鑰健康狀態。
  2. 點選金鑰以查看最近的錯誤訊息。
  3. 使用 測試金鑰 按鈕確認金鑰仍然有效。
  4. 用量 頁面查看 BYOK 專屬的錯誤率。
常見問題: