腾讯混元 Hy4 preview API 价格与调用指南
Hy4 preview 是腾讯混元面向 Agent、Coding 与生产力任务优化的深度思考模型。Roko API 当前使用 hy4-preview 模型 ID，并提供 Chat Completions、Responses 与 Anthropic Messages 三类兼容入口。
Tencent Hy4 preview API 价格
价格直接读取 Roko API 当前模型快照；实时刷新结果优先于构建快照。
Tencent Hy4 preview
hy4-preview Hy4 preview 是什么模型？
腾讯云官方资料将 Hy4 preview 描述为总参数 770B、激活参数 49B 的混元模型，重点加强复杂任务中的理解、规划、工具调用和持续执行，适合需要多步骤拆解与长链路状态承接的 Agent 工作流。
模型面向代码理解、生成、修改与工程任务，同时覆盖文档处理、信息分析、办公自动化、网页与游戏开发等生产力场景。当前目录配置 1024K 上下文、最大输入 960K Token 和最大输出 64K Token。
Roko API 的已接入能力以本页“当前接入信息”为准。上游支持的功能不会自动等于网关已经开放的功能；密钥未填写或官方渠道未启用时，模型会出现在目录中但不能实际路由请求。
Hy4 preview 适合哪些场景？
以下场景来自腾讯云官方定位，并结合当前 Roko API 接入能力整理。
多步骤 Agent 工作流
适合先规划、再调用工具、读取结果并持续修正的长链路任务。
复杂代码与工程任务
适合代码库理解、跨文件修改、问题定位和需要连续执行的工程开发任务。
文档与信息分析
适合长文档归纳、资料对比、结构化提取和带有明确验收标准的知识工作。
生产力自动化
适合办公自动化、网页生成、游戏开发和需要跨工具协作的生产流程。
Tencent Hy4 preview API 常用参数
仅列出当前 Roko API 接入已经明确支持或公开配置的字段。
| 参数 | 类型 | 要求 | 说明 |
|---|---|---|---|
model | string | 必填 | 固定填写 hy4-preview。 |
messages | array | 必填 | 按顺序传入对话消息；至少包含一条用户消息。 |
stream | boolean | 可选 | 设为 true 时使用 SSE 流式返回。 |
max_tokens | integer | 可选 | 限制本次请求的最大输出，不能超过当前目录配置的 64,000 Token。 |
reasoning_effort | string | 可选 | 控制推理强度；可用值以当前上游接口响应为准。 |
tools | array | 可选 | 向模型声明可调用的函数工具及其参数结构。 |
Tencent Hy4 preview API 调用示例
使用 Anthropic Messages 请求即可接入。 API Key 应保存在服务端环境变量中。
curl https://api.rokoapi.com/v1/messages \
-H "x-api-key: $API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "hy4-preview",
"max_tokens": 4096,
"messages": [
{"role": "user", "content": "分析这个代码库的任务调度与失败恢复路径，输出风险清单、修复计划和可验证的测试步骤"}
],
"stream": true
}'计费与上线建议
- 1
当前生产模型目录配置为输入 $0.9200、输出 $2.7600 / 1M Token；页面构建和定价页均读取这组后台价格。
- 2
当前目录没有发布独立的缓存命中单价，因此本页不再展示或推算缓存价格。
- 3
深度思考产生的 Token 会计入实际 usage；长链路 Agent 应同时评估重试次数和每个成功任务总成本。
Tencent Hy4 preview API 常见问题
Tencent Hy4 preview API 使用哪个模型 ID？
使用 hy4-preview。模型 ID 区分字符，请直接复制本页显示的值。
Tencent Hy4 preview API 怎么计费？
Roko API 当前按 Token 计费：输入 $0.9200 / 1M tokens，输出 $2.7600 / 1M tokens。最终费用以实际 usage 和当前价格配置为准。
Tencent Hy4 preview API 使用哪个接口？
当前通过 OpenAI 兼容的 POST /v1/messages 调用，Base URL 为 https://api.rokoapi.com/v1。
Hy4 preview 的上下文窗口是多少？
当前目录配置为 1024K 上下文，最大输入 960K Token、最大输出 64K Token；实际请求还要受到账号级限速和上游服务限制。
Hy4 preview 支持哪些调用协议？
当前模型配置包含 Chat Completions、Responses 和 Anthropic Messages 三类入口，具体字段与返回格式请分别按对应 API 文档调用。
为什么新增后暂时调用不了？
配置脚本会以空密钥创建并禁用腾讯官方渠道。管理员需要补充 API Key、保存并启用渠道，模型才具备可用路由。
Tencent Hy4 preview 的当前接入上下文窗口是多少？
当前 Roko API 模型目录配置为 1,024,000 Token。
相关文本模型
比较同系列或其他文本模型的价格与当前接入能力。
Tencent Hy4 preview
$0.9200 / 1M tokens
DeepSeek V4 Pro
$1.2850 / 1M tokens
查看模型 → Z.ai
GLM-5.3
$1.1420 / 1M tokens
查看模型 → Moonshot
Kimi K3
$3.1400 / 1M tokens
查看模型 →