概述
ARouter 支持平台额度和自带供应商密钥(BYOK)两种模式。使用自己的密钥时,请求通过您的供应商账户路由,同时保留 ARouter 的所有功能 —— 统一 API、故障转移、分析和费用控制。 您的供应商密钥经过安全加密存储,并在路由时自动优先使用。无需修改代码 —— 只需在控制台添加密钥,现有的 ARouter API Key 照常使用。工作原理
- 在 设置 → 集成 中添加您的供应商 API 密钥。
- ARouter 自动为该供应商使用您的密钥。
- 如果您的密钥不可用,ARouter 可以回退到平台密钥(可配置)。
- 用量按 BYOK 和平台分别统计。
支持的供应商
ARouter 支持以下凭证类型的 BYOK:添加 BYOK 密钥
控制台操作
- 进入 设置 → 集成。
- 点击 添加供应商密钥。
- 选择供应商和凭证类型。
- 输入您的密钥/凭证。
- (可选)点击 测试密钥 验证有效性。
- 点击 保存。
高级选项
添加密钥时可配置:回退策略
默认情况下,如果您的 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 错误率。