O Hunyuan Hy4 é uma das principais apostas da Tencent para agentes, segundo uma avaliação, custando US$ 0,834 por 1 milhão de tokens de entrada e US$ 2,501 na saída. Mas, antes de comparar preços, é preciso encarar o ponto que realmente define a implantação: o checkpoint FP8 de 786 GB.
A API foi lançada em 4 de novembro de 2026. Em 20 de novembro de 2026, a Tencent publicou os pesos de 770B no total e 49B ativos, o System Card e os links do repositório por meio de @TencentHunyuan.
Os 786 GB vêm antes da conta do Hy4
Hospedar o Hy4 por conta própria é tarefa para um datacenter. O modelo mixture-of-experts, com 770B de parâmetros totais e 49B ativos, exige cerca de 786 GB em FP8 (verificação de hardware da LimitDigest, 20 de novembro), e a própria Tencent mostra a divisão entre várias GPUs no mesmo guia.
API em 4 de novembro, pesos em 20 de novembro: o que saiu de fato
A API hy4 ganhou entrada de imagens e uso de ferramentas em relação à versão preview (guia para desenvolvedores da Tencent Cloud, 10 de novembro). Os pesos Instruct, FP8 e Base, junto do System Card, vieram em 20 de novembro. As primeiras publicações sobre pesos abertos normalmente se referiam ao Preview ou ao Flash.
O hardware que o Hy4 realmente exige
O menor arquivo GGUF que circula tem cerca de 215 GB (relato de hardware para uso individual). Uma RTX 3090 de 24 GB não consegue armazená-lo. O Hy4-Flash, com 220B de parâmetros totais e 12B ativos, é a versão que tem relatos confiáveis de execução em uma única máquina (especificações da LimitDigest). O flagship Hy4 precisa de servidores com várias GPUs.
tencent: hy4 is open weights smallest gguf: ~215 gb my 3090: 24 gb cool cool cool — @blakeothy, relato de hardware para uso individual, 20 de novembro de 2026
A licença é irrelevante para a maioria, mas pode barrar alguns negócios
O Hy4 usa a Tencent Hy License, baseada na Apache 2.0, mas com uma cláusula adicional para distribuição comercial (observações da LimitDigest sobre a licença). É necessária uma licença separada da Tencent para empresas que vendem acesso à API e têm receita anual superior a US$ 50 milhões ou um produto usado por mais de 100 milhões de usuários mensais. Antes de redistribuir o modelo comercialmente, confirme o texto vigente da licença no Hugging Face.
Preço da API Hunyuan Hy4 sem confusão de moedas
Na aba de Singapura do TokenHub da Tencent Cloud, o preço de tabela da API Hunyuan Hy4 é de US$ 0,834 por 1 milhão de tokens de entrada, US$ 2,501 por 1 milhão de tokens de saída e US$ 0,042 por 1 milhão de tokens de entrada em cache (verificação da LimitDigest em 20 de novembro, tabela de preços da ModelMenu). Na aba de Guangzhou, os valores são CNY 6 para entrada, CNY 18 para saída e CNY 0,30 para entrada em cache por 1 milhão de tokens (guia para desenvolvedores da Tencent Cloud).
| Modelo | Entrada / 1M | Entrada em cache / 1M | Saída / 1M | Contexto |
|---|---|---|---|---|
| Hunyuan Hy4 | US$ 0,834 | US$ 0,042 | US$ 2,501 | 1M |
| Hunyuan Hy4 Flash | US$ 0,07 | US$ 0,003 | US$ 0,281 | 1M |
| Hunyuan Hy3 | US$ 0,132 | US$ 0,033 | US$ 0,528 | 256K |
| Hunyuan Hy4 Preview | US$ 0,834 | US$ 0,042 | US$ 2,501 | 1M |
A entrada em cache é 95% mais barata que a entrada normal no Hy4 e 96% mais barata no Hy4 Flash. Não encontrei uma tarifa separada para gravar o cache nem sobretaxa para prompts longos nas tabelas de preços citadas.
A promoção de 50% que corta a conta até 31 de dezembro
O Hy4 fica 50% mais barato até 31 de dezembro de 2026, no horário de Pequim: US$ 0,417 para entrada e US$ 1,25 para saída por 1 milhão de tokens. A promoção separada do Flash termina em 30 de novembro (tabela de promoções da LimitDigest). Depois disso, ambos voltam ao preço de tabela.
Em uma carga com proporção de 3:1 entre entrada e saída, o Hy4 promocional fica em cerca de US$ 0,63 por 1 milhão de tokens no total, contra aproximadamente US$ 0,52 do preço de tabela do DeepSeek V4.1 Flash (cálculo combinado da LimitDigest).
960K de entrada e 64K de saída: limites que mudam a conta
O contexto total é de 1M de tokens, com até 960K tokens de entrada e 64K de saída por requisição. Novas contas do TokenHub podem resgatar 1 milhão de tokens gratuitos por modelo de linguagem, válidos por um ano, até 31 de dezembro de 2026 (observações da LimitDigest sobre o plano gratuito). A Tencent bloqueia US$ 30 para cada modelo Hunyuan ativado e devolve o valor depois que os endpoints são excluídos. Gerações canceladas continuam cobrando os tokens já produzidos.
As tarifas de revendedores vão de US$ 0,33 para entrada e US$ 1,15 para saída até US$ 0,90 e US$ 2,70, respectivamente. Compare também confiabilidade e latência, não apenas preço (tabela de provedores da AIRateCard, 5 de novembro).
Hy4, Preview e Flash em uma só tabela
hy4-preview e hy4 têm o mesmo preço de tabela e contexto de 1M, mas apenas o modelo completo aceita imagens (teste de integração da BUMO, 8 de novembro). A Tencent marca o hy4-preview como "To Be Discontinued", sem informar uma data de encerramento (verificação de status da LimitDigest).
| Variante | ID do modelo | Visão | Status | Quando usar |
|---|---|---|---|---|
| Hunyuan Hy4 | hy4 / tencent/hy4 nos roteadores | Sim | Atual | Trabalho com agentes, agentes de código e fluxos com imagem e texto |
| Hunyuan Hy4 Preview | hy4-preview | Não | To Be Discontinued | Migre imediatamente para hy4, pelo mesmo preço |
| Hunyuan Hy4 Flash | hy4-flash | Sim | Atual | Tarefas em lote de alto volume depois de testar os prompts |
Em uma carga de 3:1, o Flash custa cerca de 5 vezes menos; no cenário de 4:1 abaixo, a diferença chega a aproximadamente 10 vezes. Consulte também preços da API Hunyuan Hy4 Flash e preços da API Hy4 Preview.
Como chamar o Hy4 sem desperdiçar tokens de saída com o thinking
O Hy4 é compatível com a API da OpenAI por meio de roteadores como a BUMO, que documenta o uso de tencent/hy4 nos formatos OpenAI e Anthropic (teste da BUMO). A armadilha de custo está nos tokens de raciocínio, cobrados como saída: no teste citado, uma tarefa de verificar palíndromo gerou 971 tokens de thinking dentro de 1.009 tokens de saída, em 24 segundos e por cerca de CNY 0,018 com o thinking ativado. Com o recurso desativado, foram 45 tokens em 2,9 segundos, por cerca de 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"}},
)Naquele teste, enable_thinking: false não desativou o thinking; quem funcionou foi {"thinking": {"type": "disabled"}}. Quando o thinking estiver ligado, mantenha max_tokens alto: o limite de 2.048 tokens foi quase todo consumido pelo conteúdo de raciocínio, sem espaço para chamadas de ferramentas. Para chaves e endpoints oficiais do TokenHub, siga o guia para desenvolvedores da Tencent Cloud.
O Claude Code acrescenta /v1/messages sozinho, portanto sua URL base não deve incluir /v1. Ele registra unrecognized_model para tencent/hy4, mas isso não impede chamadas de ferramentas. Em uma execução de 9 turnos para corrigir, testar e verificar, foram usados 11.895 tokens de entrada sem cache, 68.224 tokens de entrada em cache e 797 tokens de saída, por cerca de CNY 0,106 (execução do Claude Code com a BUMO).
O que os primeiros usuários estão relatando
A posição 17 de 45 no LMArena Agent Arena e 22 de 58 no Code Arena, contra 24 e 19 do DeepSeek V4.1 Flash e 18 e 15 do Kimi K3.1 Pro, é o retrato citado em 20 de novembro (verificação do ranking pela LimitDigest). Encare essas posições como uma indicação geral, não como uma verdade definitiva.
i ran into some issues with the hy4 model after like 400k context where at times the model was looping. — u/Constant_Art_20 em r/ArtificialIntelligence, relato real sobre uso com contexto longo
Equipes que planejam cargas acima de 700K devem fazer seu próprio teste de needle-in-a-haystack antes de presumir que a qualidade será uniforme em toda a janela de 1M.
Quem deveria pagar pelo Hy4
| Carga de trabalho | Escolha | Motivo |
|---|---|---|
| Agentes de escritório e fluxos longos com ferramentas | Hy4 durante a promoção | 17º no Agent Arena, contexto de 1M e descontos de cache para prompts repetidos |
| Completar código barato em escala | DeepSeek V4.1 Flash | Preço de saída menor, 19º no Code Arena contra 22º do Hy4 |
| Extração em lote e reescritas curtas | Hy4 Flash depois de testar | Cerca de US$ 2,81 para 20M de entrada e 5M de saída, contra US$ 29,18 do Hy4 no preço de tabela |
Tráfego existente em hy4-preview | hy4 agora | Mesmo preço, adiciona visão e o Preview está sendo descontinuado |
Um mês de uso médio, com 20M de tokens de entrada e 5M de saída, custa cerca de US$ 29,18 no Hy4 pelo preço de tabela, aproximadamente US$ 14,59 durante a promoção e cerca de US$ 2,81 no Hy4 Flash pelo preço de tabela. Em sessões de agentes com muito cache, o total muda mais conforme o posicionamento do prompt do que pela escolha do modelo, desde que os trechos estáveis permaneçam no início da requisição.
Depois de 31 de dezembro, com o preço cheio em vigor, cargas mais voltadas a código devem comparar novamente o Hy4 com o DeepSeek V4.1 Flash, em vez de escolher o Hy4 automaticamente.
Perguntas frequentes
Quanto custa a API Hunyuan Hy4?
US$ 0,834 para entrada, US$ 2,501 para saída e US$ 0,042 para entrada em cache por 1 milhão de tokens no preço de tabela; US$ 0,417 e US$ 1,25 durante a promoção até 31 de dezembro de 2026.
Qual é a janela de contexto do Hy4?
1M no total, com até 960K de entrada e 64K de saída por requisição. O Hy3 tem 256K.
O Hy4 Preview será encerrado?
A Tencent o marca como "To Be Discontinued", mas ainda não publicou uma data. Use hy4 para novas chamadas.
É possível hospedar o Hy4 localmente em vez de usar a API?
Sim, mas hospedar o flagship exige servidores com várias GPUs e cerca de 786 GB em FP8. Para a maioria das equipes, a API é a opção mais prática.
Como reduzir a conta do Hy4 usando cache?
Mantenha os prompts estáveis no início das requisições. A entrada em cache custa 95% menos, e os fluxos com agentes são os que mais se beneficiam.
O Hy4 funciona no Claude Code?
Sim, por meio de roteamento compatível com Anthropic usando tencent/hy4. Ele exibe um aviso de unrecognized_model, mas isso não impede as chamadas de ferramentas.