腾讯混元 Hy4 API 怎么调：价格、上下文、Claude Code / Cline 接入实测
混元 Hy4 在不墨 Router 上的模型 ID 是 tencent/hy4，每百万 token 输入 6 元、输出 18 元，缓存命中 0.3 元，1M 上下文，支持看图和工具调用。附 curl / Python 调用、关思考省钱参数和 Claude Code、Cline 配置实测。
混元 Hy4 在不墨 Router 上的模型 ID 是 tencent/hy4，当前价格是每百万 token 输入 6 元、输出 18 元，缓存命中的输入 0.3 元；上下文约 1M token，支持看图、工具调用和深度思考。 接口兼容 OpenAI 和 Anthropic 两种格式，base_url 填 https://router.bumo.cc/v1 就能用 OpenAI SDK 调，Claude Code 把 ANTHROPIC_BASE_URL 指到 https://router.bumo.cc 就能跑。
核验日期：2026-11-08。价格取自 https://router.bumo.cc/api/v1/models 的线上返回。腾讯没有公开 Hy4 正式版的国内标价，下文写的都是「Router 当前价」，不是腾讯官方价。下面的调用都用 Router Key 实际跑过，Token 数是接口返回的真实值。
价格一览
| 模型 | 模型 ID | 输入 | 缓存命中输入 | 输出 | 上下文 | 看图 |
|---|---|---|---|---|---|---|
| 混元 Hy4 | tencent/hy4 |
6 元 | 0.3 元 | 18 元 | 1,024,000 | 支持 |
| 混元 Hy4 Preview | tencent/hy4-preview |
6 元 | 0.3 元 | 18 元 | 1,024,000 | 不支持 |
单位：元 / 百万 token。正式版和 Preview 同价，正式版多了图片输入。还在用 hy4-preview 的项目直接换成 tencent/hy4。
缓存命中价只有原价的二十分之一，这一点对编程 Agent 很重要：Claude Code、Cline 每一轮都会把整段对话和系统提示重发一遍，大部分输入都能命中缓存。下文 Claude Code 实测里，约 85% 的输入 token 走的是 0.3 元的缓存价。
第一步：建一个 Router Key
登录 不墨 Router，在 API Key 页面 新建 Key 并给钱包充值。同一个 Key 能调 Router 上所有模型，混元、Kimi、GLM、千问、DeepSeek 不用分别去各家开户。
curl 调用
curl https://router.bumo.cc/v1/chat/completions \
-H "Authorization: Bearer $BUMO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tencent/hy4",
"messages": [{"role": "user", "content": "用一句话介绍你自己"}],
"thinking": {"type": "disabled"}
}'
Python（OpenAI SDK）
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["BUMO_API_KEY"],
base_url="https://router.bumo.cc/v1",
)
resp = client.chat.completions.create(
model="tencent/hy4",
messages=[{"role": "user", "content": "用 Python 写一个函数 is_palindrome(s)，判断字符串是不是回文，忽略大小写、空格和标点。只给代码。"}],
extra_body={"thinking": {"type": "disabled"}},
)
print(resp.choices[0].message.content)
print(resp.usage)
实测：一道小代码题，开思考和关思考差 16 倍
同一道「写回文判断函数」的题，各调一次：
- 默认（开思考）：输入 49 token，输出 1009 token，其中 971 是思考。耗时 24 秒，花费约 0.018 元。
- 关思考：输入 52 token，输出 45 token，耗时 2.9 秒，花费约 0.0011 元。
两次给出的代码都对：都是先过滤出字母数字、转小写，再和反转后的字符串比。这种简单题关掉思考，结果一样，钱省掉九成多，速度快 8 倍。
关思考的参数是 "thinking": {"type": "disabled"}。传 enable_thinking: false 没用，我们测过，思考照样开着。思考内容放在返回的 reasoning_content 字段，按输出价计费。
另外，开着思考时别把 max_tokens 设太小。我们在 Router 上线前的测试里遇到过一次 2048 的额度全被思考吃掉、工具没调成的情况。
实测：看图
Hy4 正式版支持图片输入，写法和 OpenAI 一样，content 里放 image_url（可以是网址，也可以是 base64 的 data: 地址）：
resp = client.chat.completions.create(
model="tencent/hy4",
extra_body={"thinking": {"type": "disabled"}},
messages=[{
"role": "user",
"content": [
{"type": "text", "text": "这张图左右两半分别是什么颜色？一句话回答。"},
{"type": "image_url", "image_url": {"url": "data:image/png;base64,..."}},
],
}],
)
我们传了一张左红右蓝的 64×32 小图，回答「左半是红色，右半是蓝色。」，输入 46 token、输出 11 token，2.8 秒。tencent/hy4-preview 不支持看图，要识图必须用正式版。
在 Claude Code 里用 Hy4
Router 兼容 Anthropic Messages 接口，Claude Code 设置环境变量就能接：
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"
export ANTHROPIC_BASE_URL="https://router.bumo.cc"
export ANTHROPIC_MODEL=tencent/hy4
export ANTHROPIC_DEFAULT_OPUS_MODEL=tencent/hy4
export ANTHROPIC_DEFAULT_SONNET_MODEL=tencent/hy4
export ANTHROPIC_DEFAULT_HAIKU_MODEL=tencent/hy4
claude
Base URL 不要带 /v1，Claude Code 会自己拼 /v1/messages。
实测：Claude Code 2.1.318，在一个 add() 函数被写成减法的小项目里，让它「运行测试、找出原因、修好、再跑一遍」。Hy4 跑了 9 轮，自己执行测试、读文件、把 a - b 改成 a + b、再跑出 ok，全程 27 秒。
这一单的 Token 用量：未命中缓存的输入 11,895，缓存命中 68,224，输出 797（含思考 319）。按 Router 价算约 0.106 元。
两点说明：
- Claude Code 会在日志里提示
unrecognized_model，因为它不认识tencent/hy4这个名字。不影响使用，工具调用都正常。 - 想省钱，可以只把 Opus 档留给 Hy4，Haiku 档（生成标题这类后台小活）换成更便宜的
glm/glm-5.3-flash。三个变量分别管什么，见 Claude Code 接国产模型。
在 Cline 里用 Hy4
Cline 设置 → API Provider 选 OpenAI Compatible，按下面填：
- Base URL：
https://router.bumo.cc/v1 - API Key：你的 Router Key
- Model ID：
tencent/hy4
想让 Cline 读截图（比如把报错截图或设计稿拖进对话），在模型设置里打开图片支持（Supports Images）。上下文窗口可以按 1,024,000 填。
说明：Cline 这一节的填法来自 Cline 的 OpenAI Compatible 配置项和 Router 接入中心，本次没有在 VS Code 里实机跑 Cline。Router 端用的是同一组地址、Key 和模型 ID，上面的 curl 和 Claude Code 都已实测。Roo Code、Kilo Code 和 Cline 同源，填法一样，见 Roo Code 接国产模型；Cursor 的填法见 Cline / Cursor 接国产模型。
Hy4 适合做什么
- 长文档：约 1M 上下文。我们在 Router 上线前用一份 7.4 万 token 的长文测过，要点总结切题，藏在中间的暗号也找得出来。
- 编程 Agent：工具调用稳定，输出价 18 元，比同样 1M 上下文的 Kimi K3.1 Pro（68 元）便宜得多。
- 看图问答：截图、图表、照片识别，正式版才支持。
写代码到底选 Hy4、Kimi 还是 GLM，我们用 Claude Code 跑了同两道题对比，见 Hy4 vs Kimi K3.1 Pro vs GLM-5.3：写代码选哪个。
常见问题
国内能直接调吗？ 能。router.bumo.cc 国内直连，人民币计费，不用翻墙、不用海外卡。
模型 ID 要写全吗？ 要写带厂商前缀的 tencent/hy4，只写 hy4 找不到模型。
腾讯云的 Key 能在 Router 上用吗？ 不能。Router 用自己的 Key，一个 Key 调所有模型。
价格会变吗？ 以 Router 模型列表 当前显示为准，本文数字是 2026-11-08 的。
