#迁移指南

从官方 API 或其他中转迁移到万模API，通常只需要三步：换 Key、换 Base URL、确认模型名。但不同客户端对 /v1 的处理不同，迁移时要先做最小验证。

#迁移前先备份

在改生产配置前，先记录旧配置：

#三步迁移

1. 在控制台创建万模API Key。
2. 把客户端或 SDK 的 base_url 改为 https://www.wanmoapi.com/v1。
3. 保持请求体结构不变，先用一个常用模型发起测试。

如果是 Claude Messages 或 Gemini 原生客户端，Base URL 可能应填 https://www.wanmoapi.com，见协议选择指南。

#SDK 示例

from openai import OpenAI

client = OpenAI(
  api_key="$WANMO_API_KEY",
  base_url="https://www.wanmoapi.com/v1",
)

Windows PowerShell 用户请把 $WANMO_API_KEY 改成 $env:WANMO_API_KEY。

#按来源迁移

#上线前检查

• 先用测试令牌跑通。
• 控制台日志能看到请求。
• 模型名属于当前分组。
• 生产服务有回滚配置。
• 批量任务有重试和限流。
• 生产 Key 不写进前端页面或公开仓库。

#常见迁移问题

#原请求体能不能不改？

同协议迁移通常不改请求体，只换 Base URL 和 Key。跨协议迁移不能直接复用请求体，例如 Chat 和 Responses 的字段结构不同。

#为什么迁移后模型不存在？

不同平台模型名不一定一致。以万模API控制台可用模型为准。

#为什么本地成功，服务器失败？

服务器可能没有配置环境变量、无法访问外网、代理不同或容器没有重启。

下一步：客户端接入 或 接口参考。