BYOK 密钥保管

使用你自己的供应商密钥。网关用你的凭据去调用供应商,用量记在你的供应商账户上而不是 Synthorai 余额上;路由、日志和统一 API 保持不变。

控制台侧边栏位置(该功能适用于你的账户时才会出现): BYOK Keys 打开 ↗

操作步骤

1. 打开 BYOK Keys,为你已有账户的供应商添加密钥。
2. 粘贴供应商密钥。它加密存储,保存后不再返回给浏览器。
3. 可选:用逗号分隔列出模型 ID,把它限定到特定模型。留空则覆盖该供应商的全部模型。
4. 发一次请求,在供应商自己的后台确认用量确实记到了那边。

限制与注意事项

• 保存后密钥不会再次显示。保管库加密存储,仅在调用供应商时于传输过程中解密。
• 供应商侧的配额变成你的。两点注意:网关在判定请求是否 BYOK **之前**就会施加自己的按模型限流;BYOK 用量仍计入 owner 设定的成员每日限额。
• 只有工作区 owner 能添加、轮换或移除 BYOK 密钥。移除后,受影响的模型在下一次请求就回落到共享凭据。
• 自定义端点可以接入你自己运行的服务或服务商的套餐，只要它兼容 OpenAI Chat Completions、OpenAI Responses 或 Anthropic Messages API。在自定义端点里填名称、API 类型、Base URL、密钥和要接管的模型；不列模型就接管所有模型。请求里的模型名不用改，会原样发给端点。这些请求不扣额度，会和其他请求一样出现在日志里。端点出错时，由自动回退到 Synthorai 额度决定是否改由 Synthorai 响应。地址必须是 https，且能从公网访问。如果端点不提供模型列表，测试连接会用你填的第一个模型发一次简短请求，费用记在你自己的账户上；这次请求会在日志里显示为连接测试。