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 Opusanthropic/claude-opus | 200K | $1.00 / 1M | $3.00 / 1M | $0.1 / 1M |
Claude Sonnetanthropic/claude-sonnet | 200K | $1.00 / 1M | $3.00 / 1M | $0.1 / 1M |
DeepSeek Chatdeepseek/deepseek-chat | 64K | $1.00 / 1M | $3.00 / 1M | $0.1 / 1M |
DeepSeek Reasonerdeepseek/deepseek-reasoner | 64K | $1.00 / 1M | $3.00 / 1M | $0.1 / 1M |
Gemini 1.5 Flashgoogle/gemini-1.5-flash | 1M | $1.00 / 1M | $3.00 / 1M | $0.1 / 1M |
Gemini 1.5 Progoogle/gemini-1.5-pro | 1M | $1.00 / 1M | $3.00 / 1M | $0.1 / 1M |
MiniMax ababminimax/abab | 25K | $1.00 / 1M | $3.00 / 1M | $0.1 / 1M |
MiniMax Textminimax/minimax-text | 25K | $1.00 / 1M | $3.00 / 1M | $0.1 / 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 即可。