从 OpenRouter 迁移到 Phaseo

​

变更内容

1. 保持负载结构不变。
2. 替换基础 URL 和 API 密钥来源。
3. 验证模型 ID 和 OpenRouter 专属请求头。
4. 逐步切换流量，并比较延迟、输出和成本。

​

开始之前

• 能访问当前 OpenRouter 集成代码和部署配置。
• 在开发、预发布和生产环境中配置 PHASEO_API_KEY。
• 准备一份生产模型 ID 和代表性提示词的简短清单。

​

1) 清点当前 OpenRouter 用法

• 搜索 openrouter.ai 端点。
• 在代码、CI 和托管环境变量中搜索 OPENROUTER_API_KEY。
• 搜索 HTTP-Referer、X-Title 等 OpenRouter 专属请求头。
• 记录当前启用的模型 ID 和备用路由逻辑。
• 找出适合移入 Gateway 预设的可复用提示词、提供商或参数默认值，避免在应用代码中重复。

​

2) 替换基础 URL 和凭据

// Before
import OpenAI from "openai";

const before = new OpenAI({
  apiKey: process.env.OPENROUTER_API_KEY,
  baseURL: "https://openrouter.ai/api/v1",
});

const response = await before.chat.completions.create({
  model: "openai/gpt-4.1-mini",
  messages: [{ role: "user", content: "Summarize our migration plan." }],
});

// After
import OpenAI from "openai";

const after = new OpenAI({
  apiKey: process.env.PHASEO_API_KEY,
  baseURL: "https://api.phaseo.app/v1",
});

const response = await after.chat.completions.create({
  model: "openai/gpt-4.1-mini",
  messages: [{ role: "user", content: "Summarize our migration plan." }],
});

# Before
curl -s "https://openrouter.ai/api/v1/chat/completions" \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4.1-mini",
    "messages": [{"role":"user","content":"Say hello"}]
  }'

# After
curl -s "https://api.phaseo.app/v1/chat/completions" \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4.1-mini",
    "messages": [{"role":"user","content":"Say hello"}]
  }'

​

3) 验证模型 ID 并映射 OpenRouter 专属行为

curl -s "https://api.phaseo.app/v1/models" \
  -H "Authorization: Bearer $PHASEO_API_KEY" | jq '.data[0:10] | map(.id)'

• 保持 Authorization: Bearer 格式不变。
• 如果 HTTP-Referer 和 X-Title 用于标识调用应用，请保留。Phaseo 也接受小写形式 http-referer 和 x-title。
• 如果调用方依赖 OpenRouter 专属响应字段，请在单一兼容层中适配。
• 如果 OpenRouter 配置使用提供商允许/拒绝列表或路由默认值，请将它们移到预设和路由与回退。

​

映射提供商控制项

​

4) OpenRouter 行为一致性检查清单

• 基础 URL 已更新为 https://api.phaseo.app/v1。
• 所有环境中的 OPENROUTER_API_KEY 已替换为 PHASEO_API_KEY。
• 已通过 /v1/models 验证所有生产模型 ID。
• 已通过 /v1/chat/completions 或 /v1/responses 验证一项非流式请求。
• 已通过生产应用使用的同一集成路径验证一项流式请求。
• 已重新检查 GET /v1/generations?id=<request_id>；当 replay_supported=true 时，可从已存储的 replay_request 重放失败请求。
• 已使用真实提示词重新检查工具调用和结构化输出。
• 已在预发布环境验证无效密钥和无效模型错误。
• 已删除或明确规范化 OpenRouter 专属请求头和响应字段。
• 在适用时，已将共享提示词和路由默认值移入预设。

​

代理迁移清单

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 并记录每个新旧模型映射。
4. 在一个兼容模块中适配 OpenRouter 专属路由选项或响应字段。
5. 执行下方的健康检查、模型查询、请求、流式和失败路径验证。
6. 汇报改动文件、密钥名称变化、模型映射、测试证据、行为差异和回滚方式。

​

5) 安全地逐步发布

1. 首先只使用内部流量。
2. 切换到 5–10% 的生产流量，比较质量、延迟和成本。
3. 确认行为一致后再提升到 100%。
4. 完全稳定前，确保只需切换 URL 和密钥即可回滚。

​

验证命令

curl -s "https://api.phaseo.app/v1/health"
curl -s "https://api.phaseo.app/v1/models" -H "Authorization: Bearer $PHASEO_API_KEY"
curl -s "https://api.phaseo.app/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -d '{"model":"openai/gpt-4.1-mini","messages":[{"role":"user","content":"Say hello"}]}'

curl -N "https://api.phaseo.app/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -d '{"model":"openai/gpt-4.1-mini","stream":true,"messages":[{"role":"user","content":"Reply with: stream works"}]}'

curl -s "https://api.phaseo.app/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -d '{"model":"invalid/migration-test","messages":[{"role":"user","content":"test"}]}'

• 通过应用级集成测试运行一项流式请求。
• 对无效密钥或模型运行一项负向测试。
• 重放一小组基准提示词并比较输出。

​

后续步骤

• 免费获取 OpenRouter 集成迁移帮助
• 打开 OpenRouter 交互式迁移指南
• 比较 Phaseo 和 OpenRouter
• 快速入门
• API 参考：模型
• 示例
• 错误处理