Tarif de lancement (jusqu’au 25 déc.), garanti tant que vous restez abonné : Go à $10/mois (au lieu de $20), Plus avec Opus 5.5 à seulement $30/mois (au lieu de $50)S’abonner →

Tarifs de l’API Hunyuan Hy4 : guide des poids ouverts de 786 Go

À 0,834 $ par million de tokens en entrée et 2,501 $ en sortie, Hunyuan Hy4 fait partie des meilleurs choix de Tencent pour les agents selon un évaluateur. Mais avec un checkpoint FP8 de 786 Go, la question du déploiement se pose avant même celle du prix.

L’API a été lancée le 4 novembre 2026. Le 20 novembre 2026, Tencent a publié les poids du modèle — 770 milliards de paramètres au total, dont 49 milliards actifs — ainsi que sa System Card et les liens vers le dépôt, via @TencentHunyuan.

Avec Hy4, les 786 Go comptent davantage que le tarif

Auto-héberger Hy4 relève clairement du déploiement en datacenter : ce modèle mixture-of-experts de 770 milliards de paramètres au total, dont 49 milliards actifs, demande environ 786 Go en FP8 (vérification matérielle de LimitDigest, 20 nov.). Tencent montre d’ailleurs un découpage sur plusieurs GPU dans le même guide.

API le 4 novembre, poids le 20 novembre : ce qui a réellement été publié

L’API hy4 a ajouté la prise en charge des images et des outils par rapport à la Preview (guide développeur de Tencent Cloud, 10 nov.). Les poids Instruct, FP8 et Base, ainsi que la System Card, sont arrivés le 20 novembre. Les précédentes annonces de poids ouverts faisaient généralement référence à Preview ou Flash.

Le matériel réellement nécessaire pour Hy4

Le plus petit fichier GGUF qui circule pèse environ 215 Go (retour matériel d’un utilisateur). Une RTX 3090 de 24 Go ne peut pas le contenir. Hy4-Flash, avec 220 milliards de paramètres au total et 12 milliards actifs, est la version qui bénéficie de retours crédibles sur une machine unique (caractéristiques de LimitDigest). Le Hy4 phare nécessite des serveurs équipés de plusieurs GPU.

tencent : le plus petit GGUF de hy4 : environ 215 Go ma 3090 : 24 Go parfait parfait parfait — @blakeothy, retour matériel d’un utilisateur, 20 novembre 2026

La licence : secondaire pour la plupart des équipes, déterminante pour certaines

Hy4 utilise la Tencent Hy License, fondée sur Apache 2.0 mais assortie d’une clause supplémentaire concernant la distribution commerciale (notes de LimitDigest sur la licence). Une licence Tencent distincte est nécessaire pour une entreprise qui vend un accès à une API si son chiffre d’affaires annuel dépasse 50 millions de dollars ou si son produit sert plus de 100 millions d’utilisateurs mensuels. Avant toute redistribution commerciale, vérifiez le texte actuel de la licence sur Hugging Face.

Tarifs de l’API Hunyuan Hy4 : fini la confusion entre devises

Sur l’onglet Singapour de Tencent Cloud TokenHub, le tarif catalogue de l’API Hunyuan Hy4 est de 0,834 $ par million de tokens en entrée, 2,501 $ par million en sortie et 0,042 $ par million de tokens d’entrée mis en cache (vérification LimitDigest du 20 novembre, tableau tarifaire de ModelMenu). Sur l’onglet Guangzhou, les tarifs sont de 6 CNY en entrée, 18 CNY en sortie et 0,30 CNY pour l’entrée mise en cache, toujours par million de tokens (guide développeur de Tencent Cloud).

ModèleEntrée / 1 MEntrée mise en cache / 1 MSortie / 1 MContexte
Hunyuan Hy40,834 $0,042 $2,501 $1 M
Hunyuan Hy4 Flash0,07 $0,003 $0,281 $1 M
Hunyuan Hy30,132 $0,033 $0,528 $256 K
Hunyuan Hy4 Preview0,834 $0,042 $2,501 $1 M

Pour Hy4, l’entrée mise en cache coûte 95 % de moins que l’entrée standard, et 96 % de moins pour Hy4 Flash. Les tableaux tarifaires cités ne mentionnent ni frais distincts d’écriture du cache ni supplément lié aux longs prompts.

La promotion de 50 % qui réduit la facture jusqu’au 31 décembre

Hy4 bénéficie d’une remise de 50 % jusqu’au 31 décembre 2026, heure de Pékin : 0,417 $ en entrée et 1,25 $ en sortie par million de tokens. La promotion distincte de Flash se termine le 30 novembre (tableau promotionnel de LimitDigest). Les deux modèles repasseront ensuite à leur tarif catalogue.

Avec un ratio de trois tokens en entrée pour un token en sortie, Hy4 en promotion revient à environ 0,63 $ par million de tokens au total, contre environ 0,52 $ pour le tarif catalogue de DeepSeek V4.1 Flash (calcul mixte de LimitDigest).

960 K en entrée, 64 K en sortie : les limites qui modifient la facture

Le contexte total atteint 1 million de tokens, avec jusqu’à 960 K tokens en entrée et 64 K en sortie par requête. Les nouveaux comptes TokenHub peuvent obtenir 1 million de tokens gratuits par modèle de langage, valables un an, jusqu’au 31 décembre 2026 (informations de LimitDigest sur l’offre gratuite). Tencent bloque 30 $ pour chaque modèle Hunyuan activé, puis rembourse cette somme après la suppression des endpoints. Les générations annulées sont tout de même facturées pour les tokens déjà produits.

Les tarifs des revendeurs vont de 0,33 $ en entrée et 1,15 $ en sortie à 0,90 $ et 2,70 $. Comparez donc la fiabilité et la latence, pas uniquement le prix (tableau des fournisseurs d’AIRateCard, 5 nov.).

Hy4, Preview ou Flash : le comparatif en un coup d’œil

hy4-preview et hy4 partagent le même tarif catalogue et un contexte de 1 million de tokens, mais seul le modèle complet accepte les images (test d’intégration de BUMO, 8 nov.). Tencent indique que hy4-preview est « To Be Discontinued », sans annoncer de date d’arrêt (vérification du statut par LimitDigest).

VersionID du modèleVisionStatutQuand l’utiliser
Hunyuan Hy4hy4 / tencent/hy4 sur les routeursOuiActuelAgents, agents de programmation, workflows mêlant images et texte
Hunyuan Hy4 Previewhy4-previewNonTo Be DiscontinuedMigrer immédiatement vers hy4, au même prix
Hunyuan Hy4 Flashhy4-flashOuiActuelTraitements en volume après des tests au niveau des prompts

Sur un ratio de 3:1, Flash coûte environ cinq fois moins cher, et environ dix fois moins cher pour la charge 4:1 détaillée plus bas. Voir aussi les tarifs de l’API Hunyuan Hy4 Flash et les tarifs de l’API Hy4 Preview.

Appeler Hy4 sans engloutir son budget dans le thinking

Hy4 est compatible avec l’API OpenAI via des routeurs comme BUMO, qui documente tencent/hy4 avec les formats OpenAI et Anthropic (test BUMO). Le piège tarifaire vient des tokens de raisonnement, facturés au tarif des tokens de sortie : dans ce test, une tâche de palindrome a généré 971 tokens de réflexion sur 1 009 tokens de sortie, en 24 secondes et pour environ 0,018 CNY avec le thinking activé. Avec le thinking désactivé, elle s’est limitée à 45 tokens en 2,9 secondes, pour environ 0,0011 CNY.

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

Dans ce test, enable_thinking: false n’a pas désactivé le thinking ; c’est {"thinking": {"type": "disabled"}} qui a fonctionné. Si le thinking est activé, prévoyez une valeur généreuse pour max_tokens : une limite de 2 048 tokens a presque entièrement été consommée par le contenu de réflexion, ne laissant plus de place aux appels d’outils. Pour les clés et endpoints officiels de TokenHub, reportez-vous au guide développeur de Tencent Cloud.

Claude Code ajoute lui-même /v1/messages, ce qui signifie que son URL de base ne doit pas inclure /v1. Il affiche unrecognized_model pour tencent/hy4 sans bloquer les appels d’outils. Lors d’une session de correction, test et vérification en neuf tours, 11 895 tokens d’entrée non mis en cache, 68 224 tokens d’entrée mis en cache et 797 tokens de sortie ont été utilisés, pour environ 0,106 CNY (session Claude Code de BUMO).

Les premiers retours d’utilisation

Le snapshot cité au 20 novembre classe Hy4 17e sur 45 dans LMArena Agent Arena et 22e sur 58 dans Code Arena, contre respectivement 24e et 19e pour DeepSeek V4.1 Flash, et 18e et 15e pour Kimi K3.1 Pro (classements vérifiés par LimitDigest). Ces rangs doivent être considérés comme indicatifs.

J’ai rencontré quelques problèmes avec le modèle hy4 après environ 400 K tokens de contexte : par moments, il se mettait à tourner en boucle. — u/Constant_Art_20 sur r/ArtificialIntelligence, retour réel d’un utilisateur sur les longs contextes

Les équipes qui prévoient des charges dépassant 700 K tokens devraient effectuer leur propre test de type needle-in-a-haystack avant de supposer que la qualité reste homogène sur toute la fenêtre de 1 million.

À qui Hy4 s’adresse-t-il ?

Charge de travailChoixPourquoi
Agents bureautiques, boucles d’outils sur plusieurs étapesHy4 pendant la promotion17e dans Agent Arena, contexte de 1 M, remises du cache sur les prompts répétés
Complétion de code économique à grande échelleDeepSeek V4.1 FlashSortie moins chère, 19e dans Code Arena contre 22e pour Hy4
Extraction en volume, réécriture de textes courtsHy4 Flash après testsEnviron 2,81 $ pour 20 M en entrée et 5 M en sortie, contre 29,18 $ pour Hy4 au tarif catalogue
Trafic existant sur hy4-previewhy4 dès maintenantMême prix, prise en charge des images et retrait prochain de Preview

Un mois d’utilisation moyen avec 20 M de tokens en entrée et 5 M en sortie coûte environ 29,18 $ avec Hy4 au tarif catalogue, 14,59 $ pendant la promotion et 2,81 $ avec Hy4 Flash au tarif catalogue. Pour les sessions d’agents fortement dépendantes du cache, la position des prompts stables au début de la requête peut davantage modifier le total que le choix du modèle.

Après le 31 décembre, une fois le tarif catalogue rétabli, les charges orientées vers le code devront faire l’objet d’un nouveau comparatif entre Hy4 et DeepSeek V4.1 Flash plutôt que de partir automatiquement sur Hy4.

FAQ

Combien coûte l’API Hunyuan Hy4 ?

0,834 $ en entrée, 2,501 $ en sortie et 0,042 $ pour l’entrée mise en cache par million de tokens au tarif catalogue ; 0,417 $ et 1,25 $ pendant la promotion jusqu’au 31 décembre 2026.

Quelle est la taille de la fenêtre de contexte de Hy4 ?

1 million de tokens au total, avec jusqu’à 960 K en entrée et 64 K en sortie par requête. Hy3 est limité à 256 K.

Hunyuan Hy4 Preview va-t-il disparaître ?

Tencent le classe « To Be Discontinued », sans avoir publié de date. Utilisez hy4 pour les nouvelles requêtes.

Peut-on auto-héberger Hy4 au lieu d’utiliser l’API ?

Oui, mais l’auto-hébergement du modèle phare nécessite des serveurs équipés de plusieurs GPU : environ 786 Go en FP8. La plupart des équipes ont intérêt à passer par l’API.

Comment réduire la facture Hy4 grâce au cache ?

Placez les prompts stables au début des requêtes. L’entrée mise en cache coûte 95 % moins cher, et les boucles d’agents sont les premières à en profiter.

Hy4 fonctionne-t-il dans Claude Code ?

Oui, via un routage compatible Anthropic avec tencent/hy4. Un avertissement unrecognized_model peut apparaître, mais il ne bloque pas les appels d’outils.