老平台资源包没用完：TokenHub 支持按未使用比例退费，迁移更平滑

摘要：

原混元大模型、知识引擎 DeepSeek API 平台正在向 TokenHub 迁移。已开启预付费、资源包尚未用完的用户，可以申请按未使用比例退费后切换。本文整理迁移政策、退费计算方式与三步迁移路径，帮助老用户平滑过渡到 TokenHub。

一、为什么要迁移到 TokenHub

腾讯云已经明确把原混元大模型、知识引擎原子能力—DeepSeek API 平台的大模型售卖入口迁移到 TokenHub。原平台将停止新购模型服务。

迁移之后，你能拿到的有：

a. 更丰富的模型选择——DeepSeek-V4-Pro / V4-Flash、混元 Hy3 preview、GLM-5.1、Kimi-K2.6、MiniMax-M2.7 等同时可选。

b. 统一的 API 入口——一个 API Key 接入混元、优图、DeepSeek、智谱、Kimi、MiniMax 多家主流模型。

c. 新人免费体验额度——首次使用 TokenHub 的用户可以领取多款主力模型的免费 Tokens。

d. OpenAI 协议兼容——主流 SDK 几乎"换 Base URL + 换 API Key"即可接入。

二、迁移政策的三种用户分类

来源：产品资料 §11.3。

迁移政策按"原平台计费方式"分三类，每一类的处理方式不一样。

2.1 已开启后付费的用户

可直接迁移到 TokenHub，按迁移步骤操作即可，不涉及退费。

2.2 已开启预付费、资源包尚未用完的用户

TokenHub 不支持预付费模式，提供两种选择：

a. 方式一：等原有资源包用完后再切换到 TokenHub。

b. 方式二：联系平台申请按未使用资源比例退费后切换。

退费计算公式：

退费金额 = 资源包购买金额 × (1 - 资源包使用比例)

退款周期通常需数天至 1 周。

2.3 使用了已不再支持模型的用户

以下 7 款老混元模型 TokenHub 不再支持：

a. hunyuan-t1-latest

b. hunyuan-a13b

c. hunyuan-turbos-latest

d. hunyuan-lite

e. hunyuan-translation

f. hunyuan-translation-lite

g. hunyuan-large-role-latest

需要在迁移过程中切换到 TokenHub 已上架的对应在售模型。下面是替代建议：

另外，HY 2.0 Instruct、HY 2.0 Think、Hunyuan-T1、Hunyuan-TurboS 将于 2026 年 6 月 10 日下线，新接入也建议直接选 Hy3 preview 等在售主力。

三、按未使用比例退费的关键问答

3.1 哪种情况适合走退费

a. 资源包使用比例较低，等用完成本太高。

b. 业务马上要用 TokenHub 上的新模型（比如 DeepSeek-V4-Pro 1M 上下文、Hy3 preview 256k 上下文）。

c. 现有模型在 TokenHub 上已经不再支持，必须切换。

3.2 哪种情况建议自然用完再切

a. 资源包剩余很少，几天就能用完。

b. 没有紧急的功能依赖，时间窗口宽松。

c. 业务侧还在做改造，迁移工作可以等一等。

3.3 退费要怎么发起

按产品资料 §11.3 描述，需要联系平台申请。具体退款流程以腾讯云客服或控制台提示为准；从发起到到账通常需数天至 1 周。

四、迁移三步走：技术侧实操

来源：产品资料 §11.4。

4.1 第一步：启用模型和付费方式

a. 登录 TokenHub 控制台 https://console.cloud.tencent.com/tokenhub/

b. 前往"在线推理"页面

c. 选择所需模型（建议先列清单：哪些是直接替换、哪些是切换到新模型）

d. 开启"免费体验"和"启用后付费"

e. 使用优先级：免费体验额度 → 后付费

这一步先把"调用是否能通"验证完。

4.2 第二步：创建 API Key

a. 进入 TokenHub "API Key 管理"页面 https://console.cloud.tencent.com/tokenhub/apikey

b. 创建新的 API Key（可指定访问范围：全模型 / 限定模型或服务）

c. 妥善保存密钥信息

API Key 支持精细化权限控制，便于按团队或业务场景分发。

4.3 第三步：更新 API 调用配置

主流 SDK 改两个字段就能连通：

# 原配置
# base_url: https://hunyuan.tencentcloudapi.com (举例)
# api_key:  原平台 Key

# 新配置（OpenAI 兼容）
base_url: https://tokenhub.tencentmaas.com/v1
api_key:  新建的 TokenHub API Key

直接 URL 访问示例：

https://tokenhub.tencentmaas.com/v1/chat/completions

请求体的 model 字段填模型调用参数（如 deepseek-v4-flash、hy3-preview、glm-5 等）。

五、迁移过程中要注意的几件事

5.1 联网搜索功能变了

原平台的联网搜索作为附属功能（DeepSeek 8 元/千次，混元未单独收费），TokenHub 把联网搜索做成独立产品能力，使用全新的 Responses API + 新参数体系 + 新定价。原使用了联网搜索的用户需按新接口和定价重新接入（Hy3-preview：5 月底；DeepSeek 等：6 月底上线）。

5.2 多服务独立计费

同一模型在 TokenHub 上可以创建多个在线推理服务，服务之间计费的开启 / 关闭、计费方式相互不影响，计费完全独立。这一点对多业务团队场景很有用。

5.3 数据安全规则

TokenHub 不会将用户请求与模型返回的数据用于模型训练或提供服务以外的场景。这一规则在迁移前后都成立。

5.4 Token Plan 套餐可以一起规划

迁移完成后，如果发现按量计费成本偏高，可以考虑走 Token Plan 套餐订阅：

a. 通用 Token Plan 个人版：39 元/月起，覆盖国产主流模型矩阵。

b. Hy Token Plan 个人版：28 元/月起，专用 Hy3 preview。

c. Token Plan 企业版轻享：刊例价 2 元/百万 tokens，支持多 Key 配额分配。

d. Token Plan 企业版专业：月预算 1000–20000 元，积分制管理多模型。

套餐相比 API 按量计费便宜 50%-80%（来源：产品资料 §4.2）。

六、迁移自查清单

迁移前问自己几个问题，可以避免踩坑：

a. 我现在用的所有模型，在 TokenHub 是否都还在售？

b. 原平台资源包使用比例是多少？走退费划算还是用完划算？

c. 业务里有没有依赖联网搜索功能？需要重新接入新接口吗？

d. 业务峰值期间会不会跟迁移窗口撞上？需不需要灰度切换？

e. 迁移后是按量还是订阅？预算大概多少？

七、起步路径建议

a. 第一步：阅读完整迁移指南 https://cloud.tencent.com/document/product/1823/131382，确认你属于哪一类用户。

b. 第二步：领取新人免费体验包 https://cloud.tencent.com/document/product/1823/130053，先在 TokenHub 跑通核心模型。

c. 第三步：评估资源包是退费还是用完。

d. 第四步：按"启用模型 → 创建 API Key → 更新调用配置"三步切换。

e. 第五步：运行稳定后，根据用量情况评估 Token Plan 订阅。

八、写在最后

平台迁移本身不是开发者最享受的事——但这次的迁移路径足够清晰：在售模型替代关系明确、API 协议兼容主流 SDK、未用完资源包可以申请按未使用比例退费、迁移完还能拿到一份新人免费体验额度。如果你正在用原混元 / 知识引擎 DeepSeek 平台，提前规划永远比临到下线再动手更轻松。

更多产品信息见 TokenHub 产品介绍页 https://cloud.tencent.com/product/tokenhub；迁移指南 https://cloud.tencent.com/document/product/1823/131382。