Hy4 preview API 接入指南：价格、渠道与第一次调用
整理腾讯混元 Hy4 preview 的 API 渠道、价格、试用方式和生产接入前的检查清单。
Hy4 preview 发布后，开发者有三种常见选择：先在 WorkBuddy 或 CodeBuddy 里试用，直接通过 TokenHub 或 OpenRouter 调 API，或者下载开源权重自行部署。选择哪一条，取决于你是在验证模型能力，还是已经准备把它接入产品。
先说结论
- 早期评估优先使用托管入口，先获得行为、延迟和成本基线。
- 49B 激活参数并不会消除 770B MoE 的权重存储和互联成本。
- 是否接入 SandBase，必须以当天实时模型目录和 API 返回为准，不能从发布稿推断。
- API key 保持在服务端，并记录 request ID、token、延迟、重试和质量结果。
先从托管体验开始
如果只是想判断 Hy4 preview 是否适合自己的任务，WorkBuddy 和 CodeBuddy 是成本最低的入口。腾讯为这两个产品提供两周限时免费体验，适合测试长程代码、跨文件办公和原型开发。体验时保存提示词、输出和失败记录，避免只凭一次顺利的 Demo 下结论。
API 价格怎么读
腾讯发布稿列出的价格是：输入每百万 token 6 元，输出每百万 token 18 元，缓存命中每百万 token 0.3 元。真正的工作流成本还包括重试、工具调用和上下文缓存。一个输入便宜但反复重试的 Agent，可能比单次输出更贵的模型还要浪费预算。
第一次接入建议设置 token 上限、超时、重试次数和失败转人工条件。每次请求记录模型版本、provider、request ID、输入输出 token、缓存命中、延迟和最终状态。
TokenHub、OpenRouter 与网关
TokenHub 适合希望使用腾讯云服务和账单体系的团队，OpenRouter 适合已经有多模型路由和统一 API 代码的开发者。无论选择哪一个，都不要把长期密钥放在浏览器端。
如果需要在多个模型之间复测同一个工作流，可以使用 SandBase 这类服务端网关统一记录用量、路由和失败情况。但应先检查 SandBase 的实时模型目录和 API 返回，确认 Hy4 preview 已实际可用后再写集成说明。
图 1：目录页可以帮助确认平台暴露了哪些模型，但是否能真正接入，仍应以实时 API 返回为准。
自部署前要算清楚
770B 总参数、49B 激活参数的 MoE 模型仍然需要较大的权重存储和高速互联。评估自部署时，至少计算量化后的权重大小、长上下文 KV cache、并发量、网络带宽和升级成本。开源权重降低了试验门槛，但没有消除运维工作。
图 2：托管模型入口可以缩短第一次实验的路径，但价格、限制和模型标识仍要在实际请求时确认。
第一次调用的验收清单
先用一个边界清晰、可回放的任务验证：输出是否符合 schema，长输入是否能引用正确证据，失败后是否能停止而不是无限循环，费用和延迟是否在预算内。通过后再增加工具权限和上下文长度。
腾讯明确提醒 Hy4 preview 仍是早期版本，复杂任务可能过度思考和过度自我验证。因此，生产接入必须保留人工审批、日志和回滚路径。
一次有用的第一次调用
选择一个能在一小时内完成、输入固定且验收条件明确的任务，例如修改一个函数、运行现有测试并返回补丁。调用前冻结提示词、工具 schema、模型标识、推理参数和代码提交；把原始请求与响应放在私有测试日志中，并脱敏客户数据。
托管路由还是开源权重
托管入口适合快速验证行为，但要确认上下文上限、速率限制、数据留存和错误语义。自部署能获得数据边界和批处理控制，却必须承担权重存储、KV cache、互联、并发和升级成本。不要用一个温热请求的峰值吞吐代表生产容量。
SandBase 可以放在哪里
如果实时模型目录和 API 返回已确认 Hy4 preview 可用，SandBase 可以提供统一请求契约、服务端密钥、request ID 和跨模型回放。它不能替代供应商能力确认，也不能抹平不同 provider 的行为差异。
结论： Hy4 preview 最适合先用托管入口验证，再根据稳定性、成本和数据边界决定 API 或自部署。把成功工作流的真实成本记录下来，比单看每百万 token 的价格更重要。
官方链接
图 3：官方研究页提供发布背景，但不能单独证明每个托管入口都支持完全相同的参数。
