Construa com CometAPIPrecisa de uma API para vários modelos?Teste o fluxo no Playground e depois crie uma chave da API quando o modelo e o custo atenderem ao seu caso de uso.
Hunyuan Hy4 e Hy4 Preview estão ambos acessíveis via CometAPI, oferecendo aos desenvolvedores uma forma de testar o principal modelo mais recente da Tencent em comparação com a versão anterior dentro da mesma integração de API. Hy4 Flash será lançado em breve.
A Tencent lançou oficialmente o Hy4 em 4 de novembro de 2026. O anúncio no X apresenta o modelo com “Hy4 está aqui, novo com visão”, enquanto a página oficial de lançamento do Hy4 detalha suas melhorias em programação, uso de computador, pesquisa e produtividade.
Para desenvolvedores, o ponto de partida imediato é a na CometAPI. O modelo aparece como disponível com o identificador , com preço de $0.6672 por milhão de tokens de entrada e $2.00 por milhão de tokens de saída. Equipes que já usam Hy4 Preview podem mantê-lo como referência ao avaliar a versão completa.
Hy4 e Hy4 Preview estão acessíveis na CometAPI. Os desenvolvedores podem compará-los por meio de uma única integração compatível com OpenAI.
Hy4 foi oficialmente lançado. “Em breve” agora se aplica ao Hy4 Flash, cujos preços finais e especificações de serviço permanecem não publicados nos anúncios citados.
A versão completa adiciona compreensão visual e capacidades de uso de computador, além de raciocínio de longo horizonte mais robusto e fluxos de trabalho de produtividade.
A Tencent relata 78.9 no OSWorld 2.1 e 44.4 no Terminal Bench 4.0, com resultados adicionais cobrindo programação, automação e trabalho científico.
A CometAPI lista os preços de entrada e saída do Hy4 cerca de 20% abaixo dos preços oficiais mostrados na página do modelo.
A implantação prática requer um runtime de aplicativo: o modelo planeja e solicita ações; o runtime executa ferramentas, mantém estado e verifica resultados.
O que é Hunyuan Hy4?
Hunyuan Hy4 é o modelo principal da Tencent para raciocínio complexo, engenharia de software, trabalho de escritório, análise financeira, desenvolvimento de jogos e pesquisa científica. O lançamento de novembro estende a geração Hy4 para tarefas visuais e interação com computador, incluindo interfaces de linha de comando e interfaces gráficas.
De acordo com o relatório de lançamento da Tencent Technology, o Hy4 utiliza uma arquitetura Mixture-of-Experts com 770 bilhões de parâmetros. A documentação da API da Tencent lista uma janela de contexto de 1M tokens, com entrada máxima de API de 960.000 tokens e saída máxima de 64.000 tokens. Esses são os limites documentados pela Tencent; configure as solicitações à CometAPI de acordo com os limites expostos pelo endpoint ativo.
Um modelo MoE encaminha tokens por especialistas selecionados em vez de usar cada parâmetro para cada token. O Hy4 Preview anterior divulgou 49 bilhões de parâmetros ativos da espinha dorsal por token; essa cifra do Preview deve permanecer associada ao Preview ao discutir sua arquitetura.
A Tencent afirma que os pesos do Hy4 serão open source posteriormente, com suporte de implementação sendo desenvolvido junto com vLLM e SGLang. O acesso via API já está disponível, enquanto os pesos baixáveis do modelo final são um marco de lançamento separado.
Desempenho do Hy4
O lançamento oficial da Tencent reporta os seguintes resultados. São pontuações reportadas pela Tencent sob suas configurações de avaliação; os benchmarks usam diferentes métodos de pontuação e devem ser comparados dentro de cada benchmark.
As evidências mais amplas do lançamento incluem uma avaliação financeira envolvendo 213 especialistas e 579 tarefas. A Tencent Technology informa uma pontuação média de 3.04 para o Hy4, comparada a 2.97 para o DeepSeek V4.1 Flash 1017 e 2.68 tanto para Kimi K3.1 Pro quanto para GLM-5.3 nessa avaliação.
Para uma equipe que constrói análise de documentos financeiros ou assistentes de pesquisa, isso é um motivo para incluir o Hy4 em uma comparação controlada. As pontuações de benchmark não fornecem uma latência medida ou taxa de tokens por segundo para a CometAPI; esses dados precisam ser coletados no ambiente de implantação pretendido.
Hy4 vs. Hy4 Preview: O que mudou?
A Tencent destacou três grandes melhorias na versão completa do Hy4.
Execução mais robusta de tarefas de longo horizonte
Hy4 Preview estabeleceu o foco da família em tarefas extensas de programação e produtividade. Suas fraquezas documentadas incluíam verificação excessiva e gasto de mais tempo que o necessário raciocinando sobre alguns problemas. A versão completa tem como alvo um raciocínio mais eficiente e execução mais sustentada ao longo de uma sequência de ações.
Para uma aplicação de agente, a comparação útil é se o Hy4 atinge os mesmos critérios de aceitação com menos tentativas, menos contexto repetido ou menos passos abandonados. Uma resposta mais curta só reduz o custo quando o resultado ainda passa na validação.
Compreensão visual e uso de computador
Hy4 adiciona compreensão e raciocínio visual à família. Ele pode interpretar gráficos, capturas de tela e outras imagens, enquanto seu treinamento de uso de computador cobre interação em CLI e GUI. A Tencent descreve especificamente treinamento envolvendo Blender, CAD e fluxos de trabalho que cruzam fronteiras entre aplicações.
Isso expande as tarefas que um agente pode tentar. Ele pode inspecionar um gráfico antes de apontar seus erros, examinar uma página da web após gerá-la ou usar uma captura de tela para decidir a próxima ação na interface. Execução em navegador e desktop requer um ambiente de ferramentas conectado, conforme descrito na arquitetura de runtime abaixo.
Evidências mais concretas de avaliações de produtividade
A Tencent reporta melhorias em engenharia, trabalho de escritório, finanças e jogos. O relatório de lançamento dá ao Hy4 uma taxa de aprovação de 96.15% na avaliação interna da WorkBuddy e reporta melhorias sobre o Preview de 19.1% em GameDev e 9.8% em GameLogic.
Esses resultados reforçam testar o Hy4 em trabalho de produtividade de múltiplas etapas. Seu valor é maior quando a aplicação se assemelha às tarefas avaliadas: programação, trabalho com documentos, análise estruturada e uso repetido de ferramentas.
4 cenários práticos: onde o Hy4 parece útil
A Tencent Technology testou o Hy4 em quatro cenários cobrindo programação, compreensão visual, análise financeira e planejamento.
Desenvolvimento de frontend interativo
Hy4 construiu uma página web interativa do sistema solar com planetas clicáveis, velocidade orbital ajustável e explicações adequadas para crianças. A execução reportada incluiu 15 verificações de interação no Chrome, mostrando um fluxo de trabalho que vai da geração de código à verificação no navegador. Aplicações que usam a CometAPI podem suportar esse fluxo conectando o Hy4 a ferramentas de navegador.
Planejamento visual sob restrições mutáveis
Usando uma foto de geladeira, o Hy4 planejou nove refeições ao longo de três dias dentro de um orçamento de RMB 100 e limite de 40 minutos de preparo por refeição. Ele sinalizou quatro ingredientes incertos e revisou o plano quando requisitos dietéticos mudaram, demonstrando como a compreensão visual pode apoiar planejamento sob múltiplas restrições.
Análise de gráficos financeiros
Hy4 identificou afirmações enganosas em um gráfico fictício: a receita subiu 25%, em vez dos 80% alegados, enquanto o lucro caiu 40%, apesar da afirmação de que dobrou. Ele também detectou um eixo truncado que exagerava o crescimento, combinando interpretação visual com checagens numéricas.
Agendamento e verificações de viabilidade
Diante de 555 minutos de trabalho serial dentro de uma janela de 480 minutos, o Hy4 identificou a falta de capacidade de 75 minutos e propôs três planos revisados. O cenário ilustra sua utilidade para detectar requisitos conflitantes e explicar as compensações necessárias para tornar um plano viável.
A CometAPI lista as tarifas oficiais do Hy4 da Tencent em $0.8340 para entrada e $2.50 para saída por milhão de tokens, tornando os preços de entrada e saída da CometAPI aproximadamente 20% menores. Essas tarifas se aplicam ao Hy4; consulte a tabela de preços separada para o Hy4 Preview.
Custo típico por solicitação
Para uma solicitação ilustrativa usando 10.000 tokens de entrada sem cache e 2.000 tokens de saída, a cobrança de tokens do Hy4 é:
Isso equivale a aproximadamente $0.0107 por solicitação, ou $10.67 para 1.000 solicitações com o mesmo uso de tokens. Esta é uma estimativa de custo de tokens, excluindo navegador ou infraestrutura de computação e outras cobranças de ferramentas. A precificação de leitura de cache se aplica aos tokens efetivamente cobrados como leituras de cache.
Para agentes, calcule o uso ao longo de toda a tarefa. Prompts repetidos, resultados de ferramentas, raciocínio gerado e novas tentativas podem tornar uma execução de dez etapas substancialmente mais cara do que sua resposta final sugere. A métrica de negócios útil é o gasto total dividido por tarefas concluídas com sucesso.
Como acessar a API do Hy4
Hy4 e Hy4 Preview estão ambos acessíveis via CometAPI. Use hy4 para a versão completa ou hy4-preview para comparar a versão anterior.
A CometAPI documenta duas interfaces compatíveis com OpenAI:
Chat Completions (/v1/chat/completions) usa um array messages contendo turnos de usuário e assistente. Esta é a interface usada no exemplo do Hy4 abaixo e se ajusta a aplicações já construídas em torno de mensagens de chat.
Responses (/v1/responses) usa um campo input e uma estrutura de saída diferente. Use-o quando o modelo selecionado suportar Responses explicitamente por meio da CometAPI.
Para o Hy4, comece com Chat Completions. Confira a documentação da API da CometAPI para a compatibilidade do modelo antes de mudar para Responses.
Envie sua primeira solicitação
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["COMETAPI_KEY"],
base_url="https://api.cometapi.com/v1",
)
result = client.chat.completions.create(
model="hy4", # Or "hy4-preview"
messages=[{"role": "user", "content": "Explain how to resolve a scheduling conflict."}],
)
print(result.choices[0].message.content)
Os desenvolvedores podem se preparar para o Hy4 e o Hy4 Flash tornando a camada de modelo configurável. O nome do modelo, o endpoint de API, o esquema de ferramentas, a lógica de roteamento e os scripts de avaliação não devem ser codificados rigidamente no restante da aplicação.
Antes de enviar tráfego de produção para um novo modelo, estabeleça uma linha de base com o Hy4 Preview ou outro modelo atualmente disponível. A linha de base deve cobrir as cargas de trabalho relevantes para a aplicação, como suporte ao cliente, programação, processamento de documentos ou análise de dados.
A avaliação deve registrar mais do que se a resposta final parece boa. As equipes devem acompanhar as seguintes métricas:
Taxa de conclusão de tarefas: Meça com que frequência o agente completa todo o fluxo de trabalho e entrega o resultado solicitado sem intervenção humana. Uma tarefa deve contar como bem-sucedida apenas quando todas as etapas exigidas forem concluídas, não apenas quando o modelo produzir uma resposta intermediária plausível.
Taxa de sucesso em chamadas de ferramenta: Registre com que frequência o agente seleciona a ferramenta correta, usa parâmetros válidos, recebe um resultado utilizável e continua o fluxo de trabalho com sucesso. Isso ajuda a distinguir um problema de raciocínio de um problema de integração ou de esquema.
Frequência de novas tentativas: Conte quantas vezes o agente precisa repetir uma chamada de ferramenta, regenerar uma resposta ou reiniciar uma etapa. Uma alta taxa de novas tentativas pode aumentar custos e atrasar a conclusão mesmo quando a resposta final parece correta.
Meça o tempo necessário para o modelo retornar uma resposta e, para fluxos de trabalho de agentes, o tempo necessário para concluir a tarefa completa. É útil acompanhar tanto a latência por etapa quanto a latência de ponta a ponta, pois uma resposta individual rápida ainda pode resultar em um fluxo de trabalho lento de múltiplas etapas.
Quando Hy4 e Hy4 Flash estiverem disponíveis, os desenvolvedores podem executar as mesmas cargas de trabalho em ambos os modelos e comparar qualidade de conclusão, confiabilidade, velocidade e custo.
Uma política de roteamento prática enviaria tarefas repetitivas e padronizadas para o Hy4 Flash e reservaria o Hy4 para planejamento complexo, cadeias longas de ferramentas, raciocínio visual e fluxos de trabalho que exigem comportamento de recuperação mais forte.
Hy4 Flash: um modelo prático para cargas de trabalho de alto volume
Hy4 já está disponível, enquanto Hy4 Flash deve ser lançado em breve. A Tencent ainda não anunciou sua data de lançamento. A Tencent posiciona-o como um modelo de alta eficiência de custo para aplicações práticas.
Espera-se que a versão Flash retenha as capacidades visuais e de agente do Hy4 enquanto se beneficia de um co-design mais estreito entre o modelo e os produtos da Tencent. Esse posicionamento sugere um modelo otimizado para chamadas frequentes, ciclos de resposta mais rápidos e volumes maiores de solicitações.
Hy4 seria mais adequado a tarefas de agente complexas e longas que requerem planejamento mais profundo, múltiplas chamadas de ferramenta e comportamento de recuperação mais robusto. Hy4 Flash seria mais adequado a classificação de alto volume, extração de informações, processamento rotineiro de documentos e outras tarefas estruturadas em que custo e throughput são prioridades.
Ambos os modelos podem ser úteis para cargas de trabalho visuais. Hy4 Flash pode lidar com OCR básico, classificação de imagens e extração de campos, enquanto Hy4 pode ser reservado para tarefas visuais que exigem análise entre páginas, julgamento complexo ou várias rodadas de uso de ferramentas.
Hy4 Flash também pode ser útil durante o desenvolvimento rápido de agentes. As equipes podem usá-lo para testar prompts, esquemas de ferramentas e lógica de roteamento a um custo menor antes de enviar cargas mais exigentes ao Hy4.
Para decisões críticas de segurança ou altamente difíceis, o Hy4 deve ser combinado com revisão humana. O modelo pode realizar a análise, mas uma pessoa deve permanecer responsável por ações envolvendo reembolsos, pagamentos, permissões ou outros resultados consequentes.
Sim. Ambos estão acessíveis via CometAPI. Use hy4 para o Hy4 e hy4-preview para o Preview, e mantenha o identificador do modelo configurável ao comparar resultados.
Uma chamada de API permite que o Hy4 opere meu navegador automaticamente?
Um fluxo de uso de computador precisa de uma aplicação que conecte o Hy4 a um ambiente de navegador ou desktop. A aplicação executa ações e retorna capturas de tela ou resultados de ferramentas para o modelo.
Quanto custa o Hy4 na CometAPI?
A listagem de 4 de novembro oferece preços de $0.6672 por milhão de tokens de entrada, $2.00 por milhão de tokens de saída e $0.0336 por milhão de tokens de leitura de cache. A página do modelo é a referência para tarifas atuais.
Hy4 Flash está disponível agora?
Os anúncios citados descrevem o Hy4 Flash como “em breve”. Seus preços finais e especificações de serviço não foram publicados nesses materiais.
Conclusão
Hy4 está pronto para avaliação via API na CometAPI, e o Preview dá às equipes uma linha de base para medir a melhoria. Os resultados publicados e os cenários práticos reportados tornam programação, análise visual, planejamento sob restrições e trabalho de produtividade em múltiplas etapas os lugares mais úteis para começar.
Comece pela página de API e preços do Hy4, conecte as ferramentas exigidas pelo fluxo de trabalho e compare o custo por tarefa concluída. Quando o Hy4 Flash chegar, a mesma configuração de avaliação pode determinar quais tarefas se beneficiam de seu foco em eficiência.
Benchmark
Pontuação reportada do Hy4
Carga de trabalho relevante
OSWorld 2.1
78.9
Interação com computador e tarefas de GUI
Terminal Bench 4.0
44.4
Resolução de problemas em linha de comando
FrontierCode 2.0
31.0
Tarefas de programação difíceis
AutomationBench 1.0.6
56.2
Automação em múltiplas etapas
Hy-BrowseComp 2.0 — internal
59.9
Navegação e coleta de informações
TenureTrail — internal
53.6
Tarefas de pesquisa científica
Latência média de resposta:
Uso de tokens: Acompanhe tokens de entrada, tokens de saída, tokens em cache quando aplicável e o total de tokens por solicitação. Isso mostra se o estilo de raciocínio de um modelo está criando contexto desnecessário ou sobrecarga de verificação.
Custo por tarefa concluída: Calcule o custo total de modelo e infraestrutura necessário para concluir uma tarefa bem-sucedida. Isso é mais útil do que comparar preços de tokens isoladamente, pois um modelo mais barato pode exigir mais novas tentativas, prompts mais longos ou intervenção humana adicional.
Hunyuan Hy4 está disponível no CometAPI: recursos, acesso à API - CometAPI
