如果你要用 Hunyuan Hy4 跑代理程式,API 價格確實很有吸引力:輸入每 100 萬 tokens $0.834、輸出 $2.501。不過真正決定部署方式的,往往不是價格,而是那份 786 GB 的 FP8 checkpoint。
API 於 2026 年 11 月 4 日上線;騰訊則在 2026 年 11 月 20 日,透過 @TencentHunyuan 釋出總參數量 770B、啟用參數量 49B 的模型權重、System Card 與 repository 連結。
Hy4 能不能自架,先看得下 786 GB 這個數字
Hy4 自架基本上是資料中心等級的部署。這個總參數量 770B、啟用參數量 49B 的 mixture-of-experts 模型,以 FP8 執行約需 786 GB 記憶體(LimitDigest 硬體檢查,11 月 20 日);騰訊在同一份指南中也展示了多 GPU 分片部署方式。
11 月 4 日先上 API,11 月 20 日才有完整權重
hy4 API 相較 Preview 版本加入影像輸入與工具使用能力(Tencent Cloud 開發者指南,11 月 10 日)。Instruct、FP8、Base 權重與 System Card 則在 11 月 20 日跟進釋出。早期提到的開放權重,很多其實指的是 Preview 或 Flash。
Hy4 實際需要什麼硬體?
目前流傳的最小 GGUF 檔案約為 215 GB(單使用者硬體實測),24 GB 的 RTX 3090 當然裝不下。反而是總參數量 220B、啟用參數量 12B 的 Hy4-Flash,有較可信的單機運作回報(LimitDigest 規格整理)。旗艦版 Hy4 則需要多 GPU 伺服器。
tencent:hy4 開放權重中最小的 GGUF:約 215 GB;我的 3090:24 GB。好喔,好喔,好喔 —— @blakeothy,單使用者硬體實測,2026 年 11 月 20 日
授權條款多數團隊不用操心,但商業服務商要留意
Hy4 採用 Tencent Hy License,基本上以 Apache 2.0 為基礎,但額外加入商業散布條款(LimitDigest 授權說明)。如果公司要銷售 API 存取服務,且年營收超過 $50 million,或產品每月服務超過 100 million 名使用者,便需要另外取得騰訊授權。進行商業散布前,請先在 Hugging Face 確認目前版本的授權文字。
Hunyuan Hy4 API 價格:先搞清楚幣別再比較
在 Tencent Cloud TokenHub 的新加坡頁籤中,Hunyuan Hy4 API 定價為每 100 萬輸入 tokens $0.834、每 100 萬輸出 tokens $2.501,快取輸入則是 $0.042(LimitDigest 11 月 20 日查核、ModelMenu 價格表)。廣州頁籤的價格則是每 100 萬 tokens 輸入 CNY 6、輸出 CNY 18、快取輸入 CNY 0.30(Tencent Cloud 開發者指南)。
| 模型 | 輸入/100 萬 | 快取輸入/100 萬 | 輸出/100 萬 | Context |
|---|---|---|---|---|
| Hunyuan Hy4 | $0.834 | $0.042 | $2.501 | 1M |
| Hunyuan Hy4 Flash | $0.07 | $0.003 | $0.281 | 1M |
| Hunyuan Hy3 | $0.132 | $0.033 | $0.528 | 256K |
| Hunyuan Hy4 Preview | $0.834 | $0.042 | $2.501 | 1M |
Hy4 的快取輸入比一般輸入便宜 95%,Hy4 Flash 則便宜 96%。在引用的價格表中,我沒有找到另外收取快取寫入費,或針對長 prompt 加收費用的說明。
到 12 月 31 日前,50% 優惠會把帳單砍半
Hy4 優惠至北京時間 2026 年 12 月 31 日止,折後每 100 萬 tokens 輸入 $0.417、輸出 $1.25;Flash 的獨立優惠則在 11 月 30 日結束(LimitDigest 優惠價格表)。優惠結束後,兩者都會恢復牌價。
以輸入與輸出比例 3:1 計算,優惠期間的 Hy4 每 100 萬總 tokens 混合成本約為 $0.63;DeepSeek V4.1 Flash 的牌價則約為 $0.52(LimitDigest 混合成本計算)。
每次最多 960K 輸入、64K 輸出,這會直接影響費用
總 context 為 1M tokens,每次請求最多可包含 960K 輸入與 64K 輸出。新註冊的 TokenHub 帳戶可為每個語言模型申請 1M 免費 tokens,有效期一年,申請期限至 2026 年 12 月 31 日(LimitDigest 免費額度說明)。騰訊會為每個啟用的 Hunyuan 模型暫扣 $30,刪除 endpoint 後才會退款。即使取消生成,已經產生的 tokens 仍會計費。
轉售商的價格約落在輸入 $0.33/輸出 $1.15,到輸入 $0.90/輸出 $2.70 之間;比較時別只看價格,也要把穩定性與延遲納入考量(AIRateCard 供應商價格表,11 月 5 日)。
Hy4、Preview、Flash 怎麼選?一張表看懂
hy4-preview 與 hy4 共用牌價與 1M context,但只有完整模型支援影像輸入(BUMO 整合測試,11 月 8 日)。騰訊已將 hy4-preview 標記為「To Be Discontinued」,但尚未公布關閉日期(LimitDigest 狀態查核)。
| 版本 | Model ID | 視覺能力 | 狀態 | 適用情境 |
|---|---|---|---|---|
| Hunyuan Hy4 | hy4/路由器上的 tencent/hy4 | 有 | 目前版本 | 代理程式、程式碼代理、影像加文字工作流程 |
| Hunyuan Hy4 Preview | hy4-preview | 無 | To Be Discontinued | 立即遷移到 hy4,價格相同 |
| Hunyuan Hy4 Flash | hy4-flash | 有 | 目前版本 | 先完成 prompt 層級測試,再用於大量工作 |
以輸入輸出比例 3:1 計算,Flash 約便宜 5 倍;以下面的 4:1 工作負載來看,則約便宜 10 倍。另請參考 Hunyuan Hy4 Flash API pricing 與 Hy4 Preview API pricing。
呼叫 Hy4 時,別讓思考 tokens 默默燒掉預算
Hy4 可透過 BUMO 等路由器使用 OpenAI 相容介面;BUMO 也記錄了 tencent/hy4 對 OpenAI 與 Anthropic 格式的支援(BUMO 測試)。真正容易踩到的成本陷阱,是 reasoning tokens 會按照輸出價格計費。該測試中的迴文任務,在開啟思考模式時產生 1,009 個輸出 tokens,其中 971 個是思考內容,耗時 24 秒、約 CNY 0.018;關閉思考後只產生 45 個 tokens,耗時 2.9 秒、約 CNY 0.0011。
from openai import OpenAI
client = OpenAI(
base_url="https://router.bumo.cc/v1", # BUMO Router OpenAI-compatible endpoint
api_key="sk-your-key",
)
resp = client.chat.completions.create(
model="tencent/hy4",
messages=[{"role": "user", "content": "Fix add() so tests pass."}],
max_tokens=4096,
extra_body={"thinking": {"type": "disabled"}},
)這項測試顯示,enable_thinking: false 並沒有真正關閉思考;有效的寫法是 {"thinking": {"type": "disabled"}}。如果要開啟思考模式,max_tokens 記得設得寬裕一點:2,048 tokens 的上限幾乎會被思考內容用完,最後沒有空間執行工具呼叫。若使用官方 TokenHub 金鑰與 endpoint,請依照 Tencent Cloud 開發者指南 操作。
Claude Code 會自行加上 /v1/messages,因此它的 base URL 不要包含 /v1。即使對 tencent/hy4 記錄了 unrecognized_model,也不會阻擋工具呼叫;一次 9 輪的修復、測試與驗證流程,使用了 11,895 個未快取輸入 tokens、68,224 個快取輸入 tokens,以及 797 個輸出 tokens,成本約 CNY 0.106(BUMO Claude Code 實測)。
早期使用者實際遇到什麼問題?
引用的 11 月 20 日排名快照顯示,LMArena Agent Arena 為第 17/45 名,Code Arena 為第 22/58 名;DeepSeek V4.1 Flash 則為第 24/19 名,Kimi K3.1 Pro 為第 18/15 名(LimitDigest 排名查核)。這些名次比較適合當成方向性參考。
我在 Hy4 的 context 大約到 400K 後遇到一些問題,模型有時會陷入循環。—— u/Constant_Art_20 於 r/ArtificialIntelligence,真實使用者的長 context 回報
如果團隊預計處理超過 700K 的輸入,最好先自行跑 needle-in-a-haystack 測試,不要直接假設模型在完整 1M 視窗中都能維持一致品質。
哪些工作值得付費使用 Hy4?
| 工作負載 | 建議 | 理由 |
|---|---|---|
| 辦公室代理程式、長流程工具迴圈 | 優惠期間使用 Hy4 | Agent Arena 第 17 名、1M context,快取折扣也能降低重複 prompt 成本 |
| 大規模低價程式碼補全 | DeepSeek V4.1 Flash | 輸出價格較低,Code Arena 為第 19 名,Hy4 為第 22 名 |
| 大量資料擷取、短篇改寫 | 測試後使用 Hy4 Flash | 2,000 萬輸入加 500 萬輸出約 $2.81,相較之下 Hy4 牌價約 $29.18 |
現有 hy4-preview 流量 | 立即改用 hy4 | 價格相同、增加視覺能力,而且 Preview 即將退場 |
以每月 2,000 萬輸入與 500 萬輸出 tokens 的中等用量計算,Hy4 牌價約 $29.18,優惠期間約 $14.59,Hy4 Flash 牌價則約 $2.81。對於 prompt 穩定、且固定內容放在請求前段的代理程式工作階段,快取比例往往比模型選擇更能左右最終帳單。
12 月 31 日優惠結束、恢復牌價後,程式碼導向的工作負載應重新拿 Hy4 與 DeepSeek V4.1 Flash 比較,不要預設直接選 Hy4。
常見問題
Hunyuan Hy4 API 收費多少?
牌價為每 100 萬 tokens 輸入 $0.834、輸出 $2.501、快取輸入 $0.042;截至 2026 年 12 月 31 日優惠期間,則為 $0.417/$1.25。
Hy4 的 context window 有多大?
總容量為 1M,每次請求最多 960K 輸入與 64K 輸出。Hy3 則是 256K。
Hy4 Preview 要停止服務了嗎?
騰訊已標示為「To Be Discontinued」,但尚未公布日期。新的呼叫應改用 hy4。
Hy4 可以不用 API、改成自行部署嗎?
可以,但旗艦版自架需要多 GPU 伺服器,FP8 約需 786 GB。多數團隊使用 API 會比較實際。
怎麼透過快取降低 Hy4 費用?
把穩定不變的 prompt 放在每次請求的前段。快取輸入便宜 95%,而代理程式的反覆迴圈最能受惠。
Hy4 能不能搭配 Claude Code?
可以透過 Anthropic 相容路由搭配 tencent/hy4 使用;即使出現 unrecognized_model 警告,也不會阻擋工具呼叫。