跳转到主要内容
把客户端指向 https://api.phaseo.app/v1 并使用 Phaseo 密钥,删除 Helicone-Auth,然后把仍需要的每个 Helicone-* 请求头迁移到对应的 Phaseo 设置。请求本身的改动很小;可观测性的切换同样需要仔细规划。

切换客户端

用户 ID 这类按请求变化的值放在请求上,而不是客户端上。anthropic.helicone.ai 路由改用从 Anthropic SDK 迁移中的配置。 在 Helicone AI Gateway 上,路由写在 model 字符串里。把它拆开:逗号分隔的第一项成为 model,其余项成为 models 数组;<model>/<provider> 固定写法改为 provider.only 或 provider:org/model ID;!provider 排除写法改为 provider.ignore。

映射 Helicone 请求头

迁移请求可见性

使用请求日志、请求 ID、提供商尝试和价格详情进行调试。如果团队导出遥测数据,请在切换前连接相应的可观测性目标,避免出现空档。Helicone 的异步日志不代理流量,是否保留它与替换网关是两个独立的决定。

测试并上线

确认去掉 Helicone 请求头后请求仍然成功,并且团队在事故期间仍能回答常问的问题。迁移流量之前确认:
  • 每个 Helicone URL 和 Helicone-* 请求头都已删除或映射;
  • 生产模型 ID 都出现在 GET /v1/models?format=openai 中;
  • 团队需要的告警和仪表板都有替代方案;
  • 回退仍然只需更改 base URL 和密钥。
最后修改于 2026年11月5日