第 3/7 节课 · 8 分钟

使用你自己的提供商密钥

添加你自己的提供商账户密钥,让 Phaseo 用它们路由请求,并决定何时可以改用 Phaseo 自己的提供商密钥。

使用 自带密钥(BYOK) 时,你把自己在某个提供商处的账户 API 密钥交给 Phaseo。Phaseo 仍然负责路由和记录请求,但会用你的密钥调用提供商,模型用量由你的提供商直接计费。适用的是你的提供商账户的配额、速率限制、数据政策和模型访问权限,而不是 Phaseo 的共享容量。

所有者和管理员在 设置 → 自带密钥 中添加密钥。选择提供商,选择 设置提供商密钥,然后粘贴密钥。Phaseo 会对它加密(AES-256-GCM),把它绑定到该工作区和提供商,并且不会再次显示它。把每个密钥的范围限定在需要它的模型和 API 密钥上,而不是对所有模型和密钥开放,并使用 测试 在聊天中试用它。对提供商密钥的每一次更改都会记录在工作区审计日志中。

每个提供商密钥属于以下两种类型之一,你可以拖动密钥来调整它们的顺序:

  • 优先:Phaseo 先按从上到下的顺序尝试这些密钥。
  • 回退:只有当 Phaseo 自己的路由无法完成请求时,才会改用这些密钥。

如果某个优先密钥失败,工作区的 BYOK 回退 设置决定该请求是否可以改用 Phaseo 自己的提供商密钥重试,费用从你的额度中扣除。它默认开启。如果用量必须只通过你自己的提供商账户运行,请关闭它。批处理任务目前使用 Phaseo 的密钥,而不是你的。

Phaseo 收取的费用: 每个工作区每个 UTC 月的前 250,000 个已完成 BYOK 请求不收服务费,之后按该请求以提供商价格计算的费用收取 2.5%。这笔费用从你的额度中扣除,所以要保留至少 $1 的可用额度,这同样也能覆盖回退到 Phaseo 密钥时产生的费用。该页面会显示本月的 BYOK 请求数,以及还剩多少免手续费的请求。

检验你的理解

你的工作区有一个优先的 OpenAI 密钥,并且 BYOK 回退已关闭。提供商拒绝了一个用你的密钥发出的请求。会发生什么?

学以致用

你的公司已经和某个提供商签订了承诺消费合同,财务部门希望相关用量计入该合同,而不是 Phaseo 额度。你的团队每月发送大约 400,000 个请求。你该如何设置?Phaseo 还会收取哪些费用?

显示答案

在 设置 → 自带密钥 中把该提供商密钥添加为优先密钥,并把范围限定在应该使用它的模型和 API 密钥上。如果任何用量都不能通过 Phaseo 的密钥,就关闭 BYOK 回退。模型用量由提供商计费。当月前 250,000 个已完成的 BYOK 请求 Phaseo 不收费,其余请求按提供商等价成本收取 2.5%,从额度中扣除,所以要保留少量余额。

要点

BYOK 让请求通过你自己的提供商账户发送;回退设置决定当你的密钥失败时,Phaseo 的密钥能否接手。

相关链接

进度保存在此浏览器中。

最后核对于 2026年11月17日