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请求头会得到401missing_or_invalid_authorization_header。authToken在所有 SDK 版本中都发送 Bearer。apiKey只有从@anthropic-ai/sdk1.0 和anthropic2.0 起才会这样做。 - 从现在调用 Phaseo 的环境中删除
ANTHROPIC_API_KEY。apiKey: null可以阻止旧版 TypeScript SDK 读取它,而 0.98 之前的 Python SDK 即使设置了auth_token也会读取它。
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 和密钥。