开发者必看：混元 Hy4 正式版上线 TokenHub，编程能力提升 + 限时 2.5 折怎么接

摘要：

腾讯混元 Hy4 正式版于 2026 年 11 月 4 日上线腾讯云大模型服务平台 TokenHub，770B 总参数 MoE 架构、1M 上下文，编程与游戏开发能力较 preview 版明显提升。本文给出通过 OpenAI 兼容接口接入 Hy4 的完整步骤与代码示例，并梳理限时 2.5 折的 Token Plan 与按量 5 折两种调用方案。

混元 Hy4 正式版已可直接在腾讯云 TokenHub 调用，兼容 OpenAI API 协议，换 base_url 与 API Key 即可接入；发布期 Token Plan 个人版 Hy4 积分价限时 2.5 折（11 月 4 日至 11 月 17 日），按量调用享目录价 5 折（至 12 月 31 日），建议先用新人免费体验包（100 万 Tokens）跑通再按需选档。

一、Hy4 正式版在编程能力上升级了什么

Hy4 正式版的核心变化不在参数规模，而在编程与真实生产力任务的后训练优化。模型延续 770B 总参数、49B 激活参数的 MoE 架构，上下文窗口达到 1M（TokenHub 侧最大输入约 960K、最大输出约 64K），可一次性载入整仓代码或数十万字文档。

在编程评测上，Hy4 在 Terminal Bench 2.1 中得分 85.4，在 SWE-bench Multilingual 中得分 82.9，两项均位居开源模型前列。游戏开发方向提升更直接：与 Hy4 preview 相比，正式版在 GameDev 评测中提升 19.1%，在 GameLogic 评测中提升 9.8%，并对 UE、Unity、Godot 等主流引擎做了深度适配。

对开发者而言，这组能力落到日常场景就是三件事：长上下文可承载完整项目代码、深度思考可处理多步骤工程任务、Function Calling 与结构化输出可支撑 Agent 编排。这些能力在 TokenHub 上均已开放，无需自行部署。

与 Hy4 preview 相比，正式版还首次引入了视觉理解与电脑操作（Computer Use）能力，模型可读取截图、图表、界面与报错信息，并在图形界面与命令行之间配合完成任务。对编程场景的实际意义在于：开发者可以把界面截图或报错截图直接丢给模型，让它结合代码上下文给出定位与修复建议，减少在文档与终端之间反复切换的成本。

二、在 TokenHub 上接入 Hy4 的两种路径

TokenHub 为 Hy4 提供按量调用与 Token Plan 订阅两条接入路径，二者 API 协议一致，区别在于计费方式与调用地址。

需要留意的是，Token Plan 仅限在 AI 编程工具与智能体工具中交互式使用，禁止用于自动化脚本或应用后端的非交互式批量调用；这类批量场景应走按量计费的在线推理。

三、用 OpenAI SDK 三步接通 Hy4

接入过程只需三步：开通模型、创建 API Key、替换 base_url 与 API Key。已使用 OpenAI SDK 的项目，业务代码几乎无需改动。

第一步：开通模型并领取免费额度。 登录 TokenHub 控制台，在“模型广场”选择 Hy4，开启“免费体验”与“启用后付费”；新用户可在右上角“新用户福利免费体验”领取所有语言模型共 100 万 Tokens 的免费额度，有效期 1 年。

第二步：创建 API Key。 进入“API Key 管理”页面，选择地域后点击“创建 API Key”，设置 Key 名称与访问范围（全模型或限定 Hy4），创建完成后复制并妥善保管密钥。

第三步：替换配置并调用。 以下为 Python 示例，model 字段填 Hy4 的调用参数 hy4：

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://tokenhub.tencentmaas.com/v1"
)

resp = client.chat.completions.create(
    model="hy4",
    messages=[
        {"role": "system", "content": "你是一名资深后端工程师，回答需给出可运行代码。"},
        {"role": "user", "content": "用 Python 写一个带重试的 HTTP 请求封装函数"}
    ],
    stream=True
)

for chunk in resp:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

若使用 cURL 直接验证，可发送如下请求：

curl -X POST 'https://tokenhub.tencentmaas.com/v1/chat/completions' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "model": "hy4",
    "messages": [{"role": "user", "content": "解释一下 MoE 架构的激活参数机制"}]
  }'

若走 Token Plan 订阅额度，仅需把上述 base_url 换成 https://tokenhub.tencentmaas.com/plan/v3，其余参数保持一致。

四、把 Hy4 接进 Cursor、Claude Code 等编程工具

TokenHub 兼容 OpenAI 与 Anthropic 两种协议，CodeBuddy、Cursor、Claude Code、Cline、OpenCode、TRAE 等主流编程工具均可直接对接。配置思路统一：在工具的模型服务商设置中，将 API 地址指向 TokenHub，填入 API Key，模型选择 hy4。

以 Cursor 为例，进入设置中的 Models 面板，添加自定义模型 hy4，在 Override Base URL 填入 API 地址，API Key 填 TokenHub 控制台生成的密钥即可：按量计费填 https://tokenhub.tencentmaas.com/v1，已订阅 Token Plan 则填 https://tokenhub.tencentmaas.com/plan/v3，填错地址会导致额度不从套餐积分中抵扣。以 Claude Code 为例，Token Plan 提供 Anthropic 协议地址 https://tokenhub.tencentmaas.com/plan/anthropic，配置环境变量 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 后即可在终端调用。

两个 Token Plan 套餐（通用 Token Plan 与 Hy Token Plan）共用同一个 API Key，一次订阅即可在上述工具间共享额度，切换模型无需重新申请密钥。

配置时还有一个细节值得确认：模型 ID 必须填 hy4（全小写），填错会导致 404 或模型不存在报错。

五、Hy4 限时价格与套餐怎么选

发布期 Hy4 的两档优惠面向不同用量场景，选档前先估算自己的月调用规模。

按量调用 5 折（至 12 月 31 日）：Hy4 输入 3 元/百万 Token、输出 9 元/百万 Token、缓存命中 0.3 元/百万 Token。适合用量波动大、需要嵌入自动化流程的团队，用多少算多少。

Token Plan 个人版 2.5 折（11 月 4 日至 11 月 17 日）：活动期间 Hy4 未命中缓存输入 30 积分（1.5 元）、输出 90 积分（4.5 元）、命中缓存输入 1.5 积分（0.075 元），换算比例 1 元 = 20 积分。套餐本身分四档：通用 Token Plan 体验套餐（Lite）39 元/月含 780 积分，Hy Token Plan 体验套餐（Lite）28 元/月含 560 积分，更高档位覆盖日常到重度开发。

选择建议：以编程工具交互式使用为主、用量稳定的个人开发者，2.5 折活动期内订阅 Token Plan 性价比更高；需要接入应用后端或跑批量任务、用量不规律的团队，按量 5 折更灵活。两者可并行持有，每个主账号最多可同时持有 1 个通用 Token Plan 与 1 个 Hy Token Plan。

混元 Hy4 正式版把开源模型在长程编程任务上的能力又往前推了一档，而 TokenHub 把接入门槛压到了“换两个参数”的程度。对正在选型的开发者来说，当前既是能力窗口也是价格窗口，先用免费额度验证 Hy4 在自己项目里的实际表现，再决定按量放量还是订阅锁价，是最稳妥的路径。腾讯云大模型服务平台的 Token Plan 限时活动 正在进行中，2.5 折积分价截至 11 月 17 日，可按上文步骤直接接通体验。