https://api.phaseo.app/v1,把密钥改为 PHASEO_API_KEY。请求载荷、Authorization: Bearer 请求头、provider 对象和 models 回退数组都能继续使用;只需核对模型 ID 和下表中的少数字段。
切换客户端
OPENROUTER_BASE_URL 和旧密钥。@openrouter/ai-sdk-provider 改为 @phaseo/ai-sdk-provider(参见从 Vercel AI Gateway 迁移);OpenRouter 自己的 SDK(@openrouter/sdk、PyPI 上的 openrouter)需要更换客户端,而不只是换一个 base URL。
核对模型 ID
大多数 ID 相同,但部分 org 不同:x-ai/ 对应 spacex-ai/,meta-llama/ 对应 meta/,mistralai/ 对应 mistral/。列出 Phaseo 的 ID,并用它们核对每个生产模型:
availability=all 可以查看未激活或即将推出的模型。不带 format=openai 时,响应是 Phaseo 的分页 models 列表,没有 data 数组。
映射请求字段
Phaseo 还有
provider.required_execution_region 和 provider.required_data_region,OpenRouter 中没有对应项。完整请求示例请参见按请求固定或忽略提供商和只路由到欧盟或支持 ZDR 的提供商。
把剩余的 OpenRouter 专属字段集中在一个适配器中,而不是分散在每个调用处,这样回退仍然只需更改 base URL 和密钥。
切换前验证
先对 Phaseo 运行以下检查,再通过应用自己的客户端路径运行同样的检查:- 每个环境中的
OPENROUTER_API_KEY都已替换为PHASEO_API_KEY; - 每个生产模型 ID 都出现在
GET /v1/models?format=openai中; - 使用与生产相同的客户端路径,一个非流式请求和一个流式请求通过
/v1/chat/completions或/v1/responses; - 工具调用和结构化输出流程在真实提示词下通过;
- 已处理无效密钥和无效模型的失败;
- 失败的请求可以用
GET /v1/generations?id=<request_id>查到,并且在replay_supported为true时可以用replay_request重放; - OpenRouter 专属的请求头和响应字段已删除或统一处理,共享的默认设置放在预设中。
上线
- 从内部流量开始。
- 迁移 5-10% 的生产流量,比较质量、延迟和成本。
- 确认行为一致后提升到 100%。
- 在切换稳定之前,让回退保持为更换 base URL 和密钥。
把迁移交给编程智能体
把下面这组有边界的步骤交给智能体,或安装 OpenRouter 到 Phaseo 迁移技能,它打包了同样的清点、映射、验证和回退步骤:- 在运行时代码和部署配置中搜索
openrouter.ai、OPENROUTER_API_KEY、sk-or-v1、HTTP-Referer和X-Title。 - 把客户端边界改为
https://api.phaseo.app/v1和PHASEO_API_KEY,不要把任何密钥值加入源代码管理。 - 查询
GET /v1/models?format=openai,记录每个从旧到新的模型映射。 - 在一个兼容模块中适配 OpenRouter 专属的路由选项或响应字段。
- 运行上面的健康检查、非流式、流式和失败路径检查。
- 报告已修改的文件、密钥名称的变更、模型映射、测试证据、一致性差距和回退开关。