Hy4 API

Hy4：腾讯 770B 级 MoE 旗舰

Hy4 是腾讯 Hy 团队旗舰混合专家模型的正式版，2026 年 11 月 4 日发布。Preview 版本于 2026 年 8 月 28 日发布，采用稀疏 MoE 架构：总参数 770B，每 token 激活 49B，上下文长度为 100 万 token。腾讯表示正式版相比 Preview 在预训练和后训练上都做了大幅扩展。

Hy4 发布时间线

Hy 系列分两步发布。你需要清楚自己调的是哪个检查点；这比只看模型名更重要，因为价格、效果和限流都可能不同。

发布时间取自腾讯 Hy 研究页。TokenRa 账号上实际开通的版本，一律以 console 的实时信息为准。

Hy4 与 Hy4 Preview 的差别

按腾讯的说法，正式版是在预训练和后训练上都做了大幅扩展，并不是在 Preview 基础上打补丁。下面几项是最值得重测的实操差异。

标注"以 console 为准"的单元格，其值与渠道和账号相关，请从模型目录或 console 读取。

Hy4 API 的适用场景

腾讯在 Preview 阶段的宣传重点是 Agent 工作、编码和效率场景。请用你的应用实际接收的输入来测试模型，而不是用短示例提示词。

• 读取代码仓库、规划变更、调用工具并多步重试的编码 Agent。
• 从长文档提取字段并需要注明来源条款的办公和金融工作流。
• 前端和游戏原型制作，模型需要对渲染输出进行迭代而不是给出单次文本回答。
• 管理历史、工具和用户状态、跨多轮持续运行的长期 Assistant。
• 汇总多份材料并需要可溯源结论的研究工作流。

用 OpenAI SDK 调用 Hy4

每次请求只包含任务所需的内容：明确的系统指令、足够小的上下文和清晰的输出格式。重试、截断和引用检查应在应用层处理，而不只靠提示词。

from openai import OpenAI

client = OpenAI(
    base_url="https://tokenra.io/v1",
    api_key="YOUR_API_KEY",
)

response = client.chat.completions.create(
    model="hy4",  # 使用 console 里显示的确切标识
    messages=[
        {"role": "system", "content": "你是一位精准的编程助手，请引用你使用的文件。"},
        {"role": "user", "content": "审查粘贴的模块，列出具体缺陷。"},
    ],
)
print(response.choices[0].message.content)

Hy4 API 价格与模型 ID

Hy4 按每 100 万 token 计费，输入、输出和缓存命中价格分开计算。下列单价取自 2026-11-04 的 console，按渠道设定，接入前请再核对一次。

模型 ID：hy4。渠道开通后请以 console 里列出的标识为准。

上线前检查清单

• 重跑 Preview 阶段的评测；更晚的训练检查点不能直接替换在旧版本上调好的提示词。
• API key 保存在服务端，按环境或业务分离凭证。
• 路由真实流量之前，设好显式超时、有界重试和请求追踪。
• 控制上下文增长：裁剪过时轮次、总结历史，随对话延长监控用量。
• 按正式版单价规划预算，不要沿用 Preview 或免费促销价。
• 核对提供方条款、隐私合规要求以及你的使用场景下的输出权利。

Hy4 API 常见问题

继续探索