跳转到主要内容
在仪表板中创建密钥,或使用管理密钥调用 POST /v1/keys,把它保存在你的服务器上,并在每个 Gateway 请求中作为 bearer 令牌发送。智能体应使用 CLI;参见通过智能体管理 Phaseo。
在客户端上设置一次该请求头即可。例如使用 fetch:
无需充值额度即可调用 :free 模型。付费模型需要钱包中有可用余额。

选择凭据

像对待密码一样对待密钥:不要把它们放进客户端代码和公开仓库。

安全地处理密钥

  • 每个应用和环境使用一个密钥,这样轮换一个密钥时不会影响其他服务。
  • 把密钥存放在密钥管理器中,避免它们出现在日志和错误跟踪中。
  • 在仪表板中监控每个密钥的用量,及时发现异常。
  • 删除不再使用的密钥。
轮换密钥时,先把应用切换到新密钥,再让旧密钥失效。参见密钥轮换端点。

修复身份验证错误

所有错误码参见错误与调试。
最后修改于 2026年11月7日