腾讯混元 Hy3 限时免费怎么用？WorkBuddy 接入 + 封装成自己 API 完整教程
关键词：腾讯混元 Hy3、WorkBuddy 限时免费、大模型 API 封装、AI 转发节点、可计费接口、可视化编排
适用人群：开发者、小团队、想把免费大模型变成自己接口的读者
本文解决三个问题：① Hy3 在 WorkBuddy 怎么免费开；② 免费范围与坑；③ 如何把"用 Hy3"封装成可调用、可计费的接口。步骤完整，可直接照做。
一、Hy3 限时免费：官方确认的事实
- 发布接入：腾讯混元 Hy3 于2026-07-06发布，WorkBuddy 首发接入。
- 限免时间：首发两周（7/6–7/22）；张军 7/20 宣布延长至 8 月 5 日（微博公告）。截至 今日 仍在进行，抓紧。
- 怎么开：WorkBuddy 对话界面 → 模型列表 → 选「混元 Hy3」（标「限时免费」），消耗倍率 0×、不扣额度。同期限免覆盖 CodeBuddy、元宝。
- API / 开源：TokenHub 已上线（https://console.cloud.tencent.com/tokenhub/models/detail?modelId=hy3®ionId=1 ），GitHub https://github.com/Tencent-Hunyuan/Hy3 。
参考链接：
- 腾讯云开发者社区：https://cloud.tencent.com.cn/developer/news/4205407
- 混元发布报道：https://www.cs.com.cn/ssgs/01/2026/07/06/detail_2026070610022610.html
硬参数：Hy3，MoE，295B / 激活 21B，256K 上下文，Apache 2.0 开源。免费期后输入 1 元/百万 tokens、输出 4 元/百万 tokens。
二、免费范围与避坑
| 项目 | 说明 |
|---|---|
| 能免 | 文本对话、代码生成、文档处理、数据分析、Agent 任务（0 积分） |
| 不能免 | 视频生成（头号"积分刺客"，限免期别碰） |
| 细节未知 | 每天多少次、单次多长，以客户端实时规则为准 |
三、用 WorkBuddy 把需求变成接口设计
需求示例：
「文章一句话摘要」接口：接收
article，调用腾讯混元 Hy3生成 30 字内摘要 + 3 个标签，返回 JSON，按次计费 0.01 元。
WorkBuddy 接口体检后输出设计稿：
{"name":"article_summary","method":"POST","params":{"article":"string[1,5000]"},"logic":[{"node":"AI转发","provider":"腾讯混元","prompt":"用 30 字内概括下文，并给出 3 个标签，返回 JSON：{summary, tags}"},{"node":"返回结果"}],"auth":"token","cache":"600s","billing":{"plan":"per_call","price":0.01}}四、封装成真实接口：3 步
平台要求：支持「AI 转发节点原生接腾讯混元（Hy3）」、可视化编排、自动文档、AppKey 鉴权、按次计费。
步骤 1：进入接口编辑，唤起 AI 编程，描述"用 Hy3 做文章摘要"，AI 输出编排 JSON。
步骤 2：点击「应用到编辑器」，画布出现节点；无本地库直接用「AI 转发」节点。
步骤 3：双击节点 → 模型列表选「腾讯混元」（即 Hy3 旗舰）→ 贴提示词 → 配参数/鉴权/缓存 → 在线调试 → 保存发布。
接口发布后，回到 WorkBuddy，你手里就多了一个属于自己、随时可调用、还能对外计费的 Hy3 摘要接口。在 WorkBuddy 里搭 Agent、串工作流，或交给团队用 AppKey 调——设计在 WorkBuddy，落地在平台，调用又回到 WorkBuddy，闭环跑通。
五、发布后的三件事
接口发布了，但怎么管理呢？这三件事大家可以对照着做。
自动文档 + 权限：自动出接口文档；「接口权限 → 权限规则」分配 AppKey 对外开放。
审计留痕：每次调用记「平台管理 → 审计日志」。
计费上架：计费管理设按次 0.01 元，服务大厅展示接口，外部调用即扣费。
六、边界与选型
- Hy3 限免适合测试/试错；生产评估截止（8/5）与稳定性，别压核心业务。免费期后按 token 计费（输入 1 元/百万 tokens）。
- 落地平台多为商业 + 源码交付（非纯开源），gRPC / SSE 流式暂不支持，高并发需额外架构；按团队诉求选型。