Skip to main content

概述

ARouter 支持平台额度和自带供应商密钥(BYOK)两种模式。使用自己的密钥时,请求通过您的供应商账户路由,同时保留 ARouter 的所有功能 —— 统一 API、故障转移、分析和费用控制。 您的供应商密钥经过安全加密存储,并在路由时自动优先使用。无需修改代码 —— 只需在控制台添加密钥,现有的 ARouter API Key 照常使用。

工作原理

  1. 设置 → 集成 中添加您的供应商 API 密钥。
  2. ARouter 自动为该供应商使用您的密钥。
  3. 如果您的密钥不可用,ARouter 可以回退到平台密钥(可配置)。
  4. 用量按 BYOK 和平台分别统计。

支持的供应商

ARouter 支持以下凭证类型的 BYOK:

添加 BYOK 密钥

控制台操作

  1. 进入 设置 → 集成
  2. 点击 添加供应商密钥
  3. 选择供应商和凭证类型。
  4. 输入您的密钥/凭证。
  5. (可选)点击 测试密钥 验证有效性。
  6. 点击 保存

高级选项

添加密钥时可配置:

回退策略

默认情况下,如果您的 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 错误率。
常见问题: