Skip to main content
在控制台创建密钥,将其存储在服务器上,并随 Gateway 请求作为 Bearer 令牌发送。

密钥类型

  • Gateway API 密钥用于调用工作区可用的模型、提供商和生成端点。
  • 管理 API 密钥用于调用管理 API。请参阅管理 API 密钥。
轮换密钥时,应先更新应用以使用替代密钥,再使旧凭据失效。参阅密钥轮换端点。 密钥格式为 phaseo_v1_sk_<kid>_<secret>。 请像保护密码一样保护密钥,不要将其存储在客户端代码或公开仓库中。
无需预存积分即可调用 :free 模型。付费模型需要钱包中有可用余额。

请求头格式

每个请求都要在 Authorization 请求头中包含密钥:
大多数 HTTP 客户端都允许只设置一次。例如,使用 fetch:

密钥管理检查清单


常见身份验证错误

  • 401 未授权:密钥缺失、无效,或属于已停用的工作区。
  • 403 禁止访问:密钥存在,但无权访问请求的提供商或模型。
  • 429 Too Many Requests:密钥或工作区超出限制。参阅速率限制。
  • 5xx 错误:使用指数退避后重试;如果问题仍然存在,请联系支持团队。
最后修改于 2026年10月2日