快速结论：腾讯云已把原混元大模型与知识引擎 DeepSeek API 的新增模型入口迁向 TokenHub。迁移不只是替换域名：新的 API Key 与原平台不共用，OpenAI SDK 的 base_url 改为 https://tokenhub.tencentmaas.com/v1，联网搜索参数和计费口径也有变化。生产系统应先盘点模型 ID、密钥、协议、搜索、限流和账单，再做双写比对与可回滚切换。
哪些配置必须重新核对
| 项目 | 原平台常见配置 | TokenHub 迁移动作 |
|---|---|---|
| 服务地址 | 混元或知识引擎各自域名 | OpenAI 兼容入口改为 TokenHub /v1 |
| API Key | 原平台密钥 | 在 TokenHub 控制台重新创建，不能直接复用 |
| 模型 | 旧混元/DeepSeek 模型 ID | 按当前模型列表建立显式映射，不靠名称猜测 |
| 协议 | 以 Chat Completions 为主 | 按功能选择 Chat、Responses 或 Anthropic 兼容协议 |
| 联网搜索 | enable_search: true |
按新协议使用 tools/web_search 或 web_search_options，并重算价格 |
迁移前先生成一份调用清单
- 代码、环境变量、网关和低代码平台里出现的所有旧
base_url。 - 每个业务使用的模型 ID、流式输出、工具调用、结构化输出和上下文长度。
- API Key 的创建者、使用环境、权限、轮换日期与告警接收人。
- 超时、429、5xx、内容安全拒绝与模型不可用时的重试和降级策略。
- 联网搜索的开启条件、引用字段、费用上限和结果缓存规则。
四阶段切换，不要直接全量换地址
- 沙箱验证：新建最小权限密钥，用固定输入核对非流式、流式、工具调用和中文输出。
- 影子比对：把脱敏请求复制到新入口，但不向用户返回结果，比较状态码、延迟、用量和内容结构。
- 灰度放量：从内部账号或低风险流量开始，按 1%—10%—50% 扩大，任何关键指标越界即回滚。
- 收尾撤销：稳定后冻结旧配置，保留短期回退窗口，再撤销旧密钥和删除无用告警。
迁移验收表
| 维度 | 至少检查 | 建议回滚条件 |
|---|---|---|
| 兼容性 | 字段、流式事件、工具参数、结束原因 | 客户端解析失败或关键字段丢失 |
| 质量 | 自有任务集、拒答、中文格式和引用 | 关键任务正确率低于基线 |
| 稳定性 | P50/P95 延迟、429、5xx、超时 | 错误率或延迟连续越过阈值 |
| 成本 | 输入、输出、缓存、搜索与失败重试 | 单位成功任务成本超预算 |
| 安全 | 密钥权限、日志脱敏、出口域名 | 出现越权或敏感数据落日志 |
官方来源与适用边界
本文依据腾讯云TokenHub 迁移指南、语言模型调用概览和混元产品动态整理，资料复核日期为 2026 年 8 月 19 日。模型、价格、下线日期与协议支持会变化，正式切换前必须再次查控制台与文档。可继续查看AI 工具箱、AI 编程与智能体和AI 公司与模型目录。
