从官方 SDK 迁移到统一网关：零改造成本的五个步骤
已经把代码写在 OpenAI 或 Anthropic 官方 SDK 上的项目，如何在不改业务逻辑的前提下接入统一网关？本文给出逐步迁移清单、验证方法与常见回滚方案。
1. 把 Base URL 抽成配置
如果你的代码里还硬编码着 https://api.openai.com/v1，第一步不是换地址，而是把它挪到一个环境变量里。这决定了你随时能回滚。
2. 换成网关地址与 Key
Admesh 对外只有两个信息需要记住：Base URL 是 https://api.admesh.ai/v1，Key 在控制台创建。Key 明文只在创建时展示一次，之后只保留前缀与末四位。
Admesh 实时费率（节选）
以下价格来自 Admesh 后台实时配置，单位为美元 / 每百万 Token。完整清单见模型目录。
| 模型名称与 ID | 上下文窗口 | 输入价格 / 1M | 输出价格 / 1M | 缓存命中 / 1M |
|---|---|---|---|---|
Claude Fable 5 anthropic/claude-fable-5 | 1M | $3.25 / 1M | $16.25 / 1M | $0.325 / 1M |
Claude Fable 5.1 anthropic/claude-fable-5-1 | 1M | $3.25 / 1M | $16.25 / 1M | $0.08125 / 1M |
Claude Haiku 4.5 anthropic/claude-haiku-4-5-20251001 | 200K | $0.325 / 1M | $1.625 / 1M | $0.0325 / 1M |
Claude Haiku 5.5 anthropic/claude-haiku-5-5 | 1M | $0.0325 / 1M | $0.1625 / 1M | $0.00325 / 1M |
Claude Opus 4.5 anthropic/claude-opus-4-5-20251101 | 200K | $1.625 / 1M | $8.125 / 1M | $0.1625 / 1M |
Claude Opus 4.6 anthropic/claude-opus-4-6 | 1M | $1.625 / 1M | $8.125 / 1M | $0.1625 / 1M |
Claude Opus 4.7 anthropic/claude-opus-4-7 | 1M | $1.625 / 1M | $8.125 / 1M | $0.1625 / 1M |
Claude Opus 4.8 anthropic/claude-opus-4-8 | 1M | $1.625 / 1M | $8.125 / 1M | $0.1625 / 1M |
以上为标准公有通道单价，按 Token 实际用量结算。 查看完整模型目录
3. 模型名换成 namespace/model
网关用 namespace/model 的公有模型名（例如 anthropic/…、openai/…、deepseek/…、qwen/…）。完整清单以 /v1/models 或控制台的模型目录为准，文档站也有[模型列表](https://docs.admesh.ai/zh/docs/api-reference/models)说明。
不要在代码里硬编码模型名——放到配置里，换模型就是改配置。
4. 双写对比
- 用同一批真实请求，分别打到官方 API 与网关。
- 比对三件事：响应结构（字段是否一致）、
usage字段（Token 统计口径）、流式分片行为。 - 检查错误响应：故意发一个参数错误的请求，确认错误码格式符合预期。
- 记录两边延迟与成本的差异，作为后续优化的基线。
5. 灰度与回滚
- 先把非核心流量（内部工具、低风险任务）切过去，观察一周。
- 监控三个指标：错误率、P95 延迟、单请求成本。
- 回滚方案保持简单：把环境变量改回官方地址即可，不需要改代码。
- 确认稳定后再迁移主力业务，并同步更新团队的文档与告警配置。
Anthropic 原生协议怎么办
有些代码直接使用了 Anthropic 的 Messages API 形态（/v1/messages、max_tokens 必填、system 独立字段）。Admesh 同时提供 [Anthropic 兼容端点](https://docs.admesh.ai/zh/docs/api-reference/anthropic-compatible)，这类项目不需要改写成 OpenAI 风格，只换 Base URL 与 Key 即可。
常见问题
迁移需要改业务代码吗？
通常不需要。SDK 调用方式、消息结构、流式处理逻辑都保持一致，需要改的是 Base URL、API Key 和模型名三处，其中 Base URL 与模型名建议放在配置里。
支持 LangChain、Cursor、NextChat 这类现成工具吗？
支持。只要工具允许自定义 Base URL 与 OpenAI 兼容的模型名，就能接入。文档站有 Claude Code、Codex、Cursor、Cherry Studio 等客户端的接入步骤，验证过的配置都在那里。
迁移后原来的官方账号还能留吗？
可以，而且建议保留一段时间。双写对比阶段两边都要能调，正式切换后把官方账号降级为备用，作为极端情况下的兜底。