BYOK（Bring Your Own Key）
BYOK 允许你将自有的供应商 API Key 接入 ClawdRouter 平台，享受统一的 API 管理和路由能力，同时使用自己的供应商资源。
什么是 BYOK？
BYOK（Bring Your Own Key，自带密钥）是指你可以将已有的 AI 模型供应商 API Key（如 OpenAI、Anthropic、Google 等）提交给平台，由平台为你配置专属的模型路由通道。
接入后，你的 API 请求将通过 ClawdRouter 路由到你自有的供应商 Key，享受以下优势：
- 统一接口 — 无需适配不同供应商的 API 格式，依然使用 ClawdRouter 的统一端点
- 专属通道 — 你提交的 Key 仅为你服务，不与其他用户共享
- 灵活管理 — 通过平台统一管理调用量、监控用量和错误率
适用场景
| 场景 | 说明 |
|---|---|
| 已有供应商资源 | 你已与供应商签约并拥有 API Key，希望通过 ClawdRouter 统一管理 |
| 需要专属渠道 | 希望拥有独立的调用通道，确保稳定性和隔离性 |
| 特殊定价 | 与供应商有特殊定价协议，希望使用自有的计费通道 |
| 专属模型 | 需要访问供应商提供的私有模型或微调模型 |
接入流程
1. 提交工单 → 2. 平台审核配置 → 3. 获得专属模型访问
1. 提交工单
通过工单系统提交 BYOK 接入申请：
提交 BYOK 接入工单2. 工单中需要提供的信息
请在工单中提供以下信息，以便我们快速为你完成配置：
| 信息 | 必填 | 说明 |
|---|---|---|
| 供应商名称 | 是 | 例如：OpenAI、Anthropic、Google 等 |
| API Key | 是 | 你的供应商 API Key |
| API Base URL | 否 | 如果使用非默认端点（如 Azure OpenAI），请提供完整的 Base URL |
| 需要接入的模型 | 是 | 列出需要通过该 Key 访问的模型名称 |
| 预估用量 | 否 | 预估的月度 Token 用量，便于我们优化配置 |
| 其他说明 | 否 | 任何额外的需求或注意事项 |
3. 平台审核配置
收到工单后，我们将：
- 验证你提供的 API Key 的有效性
- 为你配置专属的模型路由通道
- 完成后通过工单通知你
通常在 1-2 个工作日 内完成配置。
使用方式
BYOK 接入完成后，调用方式与普通调用完全一致。你无需修改任何代码，平台会自动将请求路由到你自有的供应商 Key。
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="__DOCS_API_ORIGIN__/v1",
)
# 调用你的专属模型 — 平台自动路由到你的供应商 Key
completion = client.chat.completions.create(
model="gpt-4o",
messages=[
{"role": "user", "content": "你好"}
],
)
print(completion.choices[0].message.content)
无需修改代码
BYOK 接入后，你的请求依然通过 ClawdRouter API Key 认证，平台在后端自动将请求路由到你的供应商 Key。你无需在代码中使用供应商原始 Key。
注意事项
Key 安全
- 请通过工单系统提交 API Key，不要 在邮件、聊天工具等不安全渠道中传输
- 提交后，平台会安全存储你的 Key，并仅用于你的专属路由通道
额度与计费
- BYOK 使用你自有的供应商额度，平台不额外收取供应商侧的调用费用
- 平台可能收取基础的路由服务费，具体以实际协议为准
- 你可以在供应商控制台查看原始用量，也可以在 ClawdRouter 控制台查看调用统计
故障排查
如果 BYOK 接入的模型出现调用失败：
- 检查供应商 Key 状态 — 确认 Key 是否有效、未过期、余额充足
- 检查模型可用性 — 确认供应商是否正常提供该模型服务
- 联系技术支持 — 携带错误信息提交工单，我们将协助排查
常见问题
BYOK 支持哪些供应商？
目前支持 OpenAI、Anthropic、Google 等主流供应商。如果你使用其他供应商，请在工单中说明，我们将评估是否支持。
BYOK 接入后可以更换 Key 吗？
可以。如需更换 Key，请提交工单，我们将为你更新配置。
BYOK 和普通调用有什么区别？
对于 API 调用者来说，两者完全一致。区别在于后端路由：普通调用使用平台的共享资源池，BYOK 调用使用你自有的供应商 Key。