Early-bird pricing (ends Dec 25), locked in while you stay subscribed: Go $10/mo (normally $20), Plus with Opus 5.5 just $30/mo (normally $50)Subscribe →

Hunyuan Hy4 API Pricing Review: 786GB Open Weights Guide

Hunyuan Hy4 is one assessor's strongest Tencent pick for agents at $0.834 input and $2.501 output per 1M tokens, but the 786 GB FP8 checkpoint decides the deployment route before price does.

The API launched November 4, 2026; Tencent released the 770B-total / 49B-active weights, System Card, and repository links on November 20, 2026 via @TencentHunyuan.

The 786 GB question decides Hy4 before price does

Hy4 self-hosting is a datacenter deployment: the 770B-total / 49B-active mixture-of-experts model needs about 786 GB in FP8 (LimitDigest hardware check, Nov 20), with Tencent showing multi-GPU sharding in the same guide.

Nov 4 API, Nov 20 weights: what actually shipped

The hy4 API added vision input and tool use over the preview (Tencent Cloud developer guide, Nov 10); Instruct, FP8, and Base weights plus the System Card followed November 20. Earlier open-weight posts usually meant Preview or Flash.

What hardware Hy4 really needs

The smallest GGUF figure circulating is around 215 GB (single-user hardware report). A 24 GB RTX 3090 cannot hold it. Hy4-Flash at 220B total / 12B active is the version with credible single-machine reports (LimitDigest specs). Hy4 flagship needs multi-GPU servers.

tencent: hy4 is open weights smallest gguf: ~215 gb my 3090: 24 gb cool cool cool — @blakeothy, single-user hardware report, November 20, 2026

License gate most teams can ignore, some cannot

Hy4 uses the Tencent Hy License, based on Apache 2.0 with an extra commercial-distribution clause (LimitDigest license notes). A separate Tencent license is required for a company selling API access if annual revenue exceeds $50 million or the product serves more than 100 million monthly users. Confirm the current license text on Hugging Face before commercial redistribution.

Hunyuan Hy4 API pricing without the currency confusion

Hunyuan Hy4 API list pricing is $0.834 per 1M input tokens, $2.501 per 1M output tokens, and $0.042 per 1M cached input tokens on Tencent Cloud TokenHub's Singapore tab (LimitDigest check Nov 20, ModelMenu pricing table). Guangzhou-tab pricing is CNY 6 input, CNY 18 output, and CNY 0.30 cached input per 1M tokens (Tencent Cloud developer guide).

ModelInput / 1MCached input / 1MOutput / 1MContext
Hunyuan Hy4$0.834$0.042$2.5011M
Hunyuan Hy4 Flash$0.07$0.003$0.2811M
Hunyuan Hy3$0.132$0.033$0.528256K
Hunyuan Hy4 Preview$0.834$0.042$2.5011M

Cached input is 95% cheaper than regular input for Hy4 and 96% cheaper for Hy4 Flash. I found no separate cache-write fee or long-prompt surcharge in the cited pricing tables.

The 50% promo that halves the bill until December 31

Hy4 is 50% off through December 31, 2026 Beijing time at $0.417 input and $1.25 output per 1M tokens; Flash's separate promotion ends November 30 (LimitDigest promo table). Each returns to list pricing afterward.

On a 3:1 input-to-output mix, promo Hy4 blends to about $0.63 per 1M total tokens against DeepSeek V4.1 Flash list at about $0.52 (LimitDigest blended math).

960K in, 64K out: the limits that change the bill

Total context is 1M tokens, with up to 960K input and 64K output per request. New TokenHub accounts can claim 1M free tokens per language model, valid one year, through December 31, 2026 (LimitDigest free-tier notes). Tencent freezes $30 per enabled Hunyuan model and refunds it after endpoints are deleted. Cancelled generations still bill for tokens already produced.

Reseller rates range from $0.33 input / $1.15 output to $0.90 / $2.70; compare reliability and latency as well as price (AIRateCard provider table, Nov 5).

Hy4 vs Preview vs Flash in one table

hy4-preview and hy4 share list pricing and 1M context, but only the full model supports image input (BUMO integration test, Nov 8). Tencent marks hy4-preview as "To Be Discontinued" with no shutdown date (LimitDigest status check).

VariantModel IDVisionStatusWhen to use
Hunyuan Hy4hy4 / tencent/hy4 on routersYesCurrentAgent work, coding agents, image plus text workflows
Hunyuan Hy4 Previewhy4-previewNoTo Be DiscontinuedMigrate to hy4 immediately, same price
Hunyuan Hy4 Flashhy4-flashYesCurrentHigh-volume bulk jobs after prompt-level testing

Flash is about 5x cheaper on a 3:1 mix, about 10x on the 4:1 workload below. See Hunyuan Hy4 Flash API pricing and Hy4 Preview API pricing.

Calling Hy4 without burning output tokens on thinking

Hy4 is OpenAI-compatible through routers such as BUMO, which documents tencent/hy4 with OpenAI and Anthropic formats (BUMO test). The cost trap is reasoning tokens billed at output rates: that test's palindrome task produced 971 thinking tokens inside 1,009 output tokens at 24 seconds and about CNY 0.018 with thinking on, versus 45 tokens at 2.9 seconds and about CNY 0.0011 with thinking off.

python
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"}},
)

In that test enable_thinking: false did not disable thinking; {"thinking": {"type": "disabled"}} did. Keep max_tokens generous when thinking is on: a 2,048-token cap was nearly consumed by thinking content, leaving no room for tool calls. For official TokenHub keys and endpoints, follow the Tencent Cloud developer guide.

Claude Code appends /v1/messages itself, so its base URL omits /v1. It logs unrecognized_model for tencent/hy4 without blocking tool calls; one 9-turn fix-test-verify run used 11,895 uncached plus 68,224 cached input tokens and 797 output tokens for about CNY 0.106 (BUMO Claude Code run).

What early users actually report

LMArena Agent Arena #17 of 45 and Code Arena #22 of 58, versus DeepSeek V4.1 Flash #24 / #19 and Kimi K3.1 Pro #18 / #15, is the cited November 20 snapshot (LimitDigest leaderboard check). Treat ranks as directional.

i ran into some issues with the hy4 model after like 400k context where at times the model was looping. — u/Constant_Art_20 on r/ArtificialIntelligence, real user long-context report

Teams planning 700K-plus loads should run their own needle-in-haystack check before assuming uniform quality at the full 1M window.

Who should pay for Hy4

WorkloadPickWhy
Office agents, long-horizon tool loopsHy4 during promoAgent Arena #17, 1M context, cache discounts repeat prompts
Cheap code completion at scaleDeepSeek V4.1 FlashLower output price, Code Arena #19 vs Hy4 #22
Bulk extraction, short rewritesHy4 Flash after testingAbout $2.81 for 20M in plus 5M out vs $29.18 Hy4 list
Existing hy4-preview traffichy4 nowSame price, adds vision, Preview is retiring

A medium month of 20M input and 5M output tokens costs about $29.18 on Hy4 list, about $14.59 during the promo, and about $2.81 on Hy4 Flash list. Cache-heavy agent sessions shift the total more than model choice when stable prompts stay at the front of the request.

At full list after December 31, code-heavy mixes should re-test Hy4 against DeepSeek V4.1 Flash instead of defaulting to Hy4.

FAQ

How much does the Hunyuan Hy4 API cost?

$0.834 input, $2.501 output, $0.042 cached input per 1M tokens at list; $0.417 / $1.25 during the promo to December 31, 2026.

What is the Hy4 context window?

1M total, up to 960K input and 64K output per request. Hy3 is 256K.

Is Hy4 Preview being shut down?

Tencent marks it "To Be Discontinued" with no date published. Use hy4 for new calls.

Can Hy4 be self-hosted instead of using the API?

Yes, but flagship self-hosting needs multi-GPU servers: about 786 GB FP8. Most teams should use the API.

How do I reduce Hy4 bills with caching?

Keep stable prompts at the front of requests. Cached input is 95% cheaper and agent loops benefit most.

Does Hy4 work in Claude Code?

Yes via Anthropic-compatible routing with tencent/hy4, with an unrecognized_model warning that does not block tool calls.