Skip to main content
BYOK 目前處於開發階段。請聯絡 support@arouter.ai 申請加入內測。
自帶密鑰(BYOK)允許您在 ARouter 中註冊您自己的服務商 API 密鑰。當請求路由到您已註冊密鑰的服務商時,ARouter 會使用您的密鑰而非其共享密鑰池。 優勢:
  • 零加價 — 直接以服務商標價付費,無 token 成本加價
  • 您自己的配額 — 請求佔用您自己的服務商頻率限制,而非 ARouter 的共享池
  • 您自己的數據政策 — 您與服務商之間現有的協議和數據條款適用
  • 統一閘道 — 仍可在上層享受 ARouter 的路由、故障切換和可觀測性

BYOK 運作原理

  1. 您在 ARouter 控制台中註冊服務商 API 密鑰
  2. 當 ARouter 將請求路由到該服務商時,它會替換為您的密鑰
  3. 您的帳戶不收取 token 成本(僅收取 ARouter 服務費,如適用)
  4. 回應中返回 usage.is_byok: true

註冊密鑰

ARouter 控制台 中新增服務商密鑰。 支援的服務商及其密鑰格式:

BYOK 與服務商排序結合

將 BYOK 與 provider.order 結合使用來控制何時使用您的密鑰:
OpenAI 在排序清單中且您已註冊 OpenAI BYOK 密鑰時,ARouter 會自動為該服務商使用您的密鑰。

部分 BYOK

您可以為部分服務商註冊密鑰,同時對其他服務商使用 ARouter 的共享池:
如果您有 Anthropic BYOK 密鑰,將首先使用您的密鑰嘗試 Anthropic。如果您有 AWS Bedrock 密鑰,接下來嘗試它。否則 ARouter 回退到其共享池。

Azure OpenAI

註冊您的 Azure OpenAI 端點和密鑰:
然後路由到它:

AWS Bedrock

兩種認證選項: 選項 1:Bedrock API 密鑰(推薦)
選項 2:AWS 憑證

Google Vertex AI


識別 BYOK 請求

當使用了您的密鑰時,回應的 usage 物件中包含 is_byok: true
is_byok: true 時,usage.cost 反映您的直接服務商成本(非 ARouter 加價)。

密鑰優先級與回退


偵錯 BYOK 問題

在控制台的活動頁面中查看每個請求使用了哪個密鑰。常見錯誤: