跳转到主要内容
保留 Anthropic SDK 和 Messages 调用。把客户端指向 https://api.phaseo.app,将 Phaseo 密钥作为 authToken 传入,并为每个模型使用其 Phaseo ID。

切换客户端

在 API 密钥中创建密钥,并将其作为 PHASEO_API_KEY 提供给应用。
这一步最常因以下三个细节出错:
  • 使用根主机。 baseURL: "https://api.phaseo.app/v1" 会生成 /v1/v1/messages。同一仓库中的 OpenAI 兼容客户端仍然使用 /v1。
  • 以 bearer 令牌发送密钥。 网关只读取 Authorization: Bearer;x-api-key 请求头会得到 401 missing_or_invalid_authorization_header。authToken 在所有 SDK 版本中都发送 Bearer。apiKey 只有从 @anthropic-ai/sdk 1.0 和 anthropic 2.0 起才会这样做。
  • 从现在调用 Phaseo 的环境中删除 ANTHROPIC_API_KEY。 apiKey: null 可以阻止旧版 TypeScript SDK 读取它,而 0.98 之前的 Python SDK 即使设置了 auth_token 也会读取它。
通过环境变量配置的工具(例如 Claude Code)使用 ANTHROPIC_BASE_URL=https://api.phaseo.app、设为 Phaseo 密钥的 ANTHROPIC_AUTH_TOKEN,以及为空的 ANTHROPIC_API_KEY。

映射模型 ID

用 GET /v1/models?format=openai 返回的 data[].id 核对每个生产模型。Phaseo ID 的版本号使用点号:claude-sonnet-5-5 变为 anthropic/claude-sonnet-5.5。如果模型也要更换,请阅读对应的模型迁移指南。

有哪些不同

测试并上线

用应用实际使用的模型 ID 测试系统提示词、流式传输、工具使用、思考和结构化输出。然后用一组有代表性的提示词比较两种配置的输出形状、延迟、token 用量、错误和成本。迁移流量之前确认:
  • 每个部署环境都设置了 Phaseo 密钥;
  • 每个生产模型 ID 都出现在 GET /v1/models?format=openai 中;
  • 流式传输和工具使用流程在预发布环境中通过;
  • 每个 anthropic-beta 请求头和仅限 beta 的字段都已删除或替换;
  • 回退仍然只需更改 base URL 和密钥。
最后修改于 2026年11月7日