跳转到主要内容
把 base URL 改为 https://api.phaseo.app/v1,把密钥改为 PHASEO_API_KEY。请求载荷、Authorization: Bearer 请求头、provider 对象和 models 回退数组都能继续使用;只需核对模型 ID 和下表中的少数字段。

切换客户端

第一轮保持载荷不变,先做到行为一致,再做优化。从代码、CI 和托管设置中删除 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 专属的请求头和响应字段已删除或统一处理,共享的默认设置放在预设中。

上线

  1. 从内部流量开始。
  2. 迁移 5-10% 的生产流量,比较质量、延迟和成本。
  3. 确认行为一致后提升到 100%。
  4. 在切换稳定之前,让回退保持为更换 base URL 和密钥。

把迁移交给编程智能体

把下面这组有边界的步骤交给智能体,或安装 OpenRouter 到 Phaseo 迁移技能,它打包了同样的清点、映射、验证和回退步骤:
  1. 在运行时代码和部署配置中搜索 openrouter.ai、OPENROUTER_API_KEY、sk-or-v1、HTTP-Referer 和 X-Title。
  2. 把客户端边界改为 https://api.phaseo.app/v1 和 PHASEO_API_KEY,不要把任何密钥值加入源代码管理。
  3. 查询 GET /v1/models?format=openai,记录每个从旧到新的模型映射。
  4. 在一个兼容模块中适配 OpenRouter 专属的路由选项或响应字段。
  5. 运行上面的健康检查、非流式、流式和失败路径检查。
  6. 报告已修改的文件、密钥名称的变更、模型映射、测试证据、一致性差距和回退开关。
如需引导式迁移,请打开交互式 OpenRouter 迁移指南,查看两者的对比,或获取免费的迁移帮助。
最后修改于 2026年11月5日