API Hunyuan Image 3 sur Novita AI : Guide de génération texte-à-image

Le Hunyuan Image 3 de Tencent est désormais disponible sur Novita AI en tant qu’API de génération texte-à-image asynchrone à l’adresse https://api.novita.ai/v3/async/hunyuan-image-3. Le modèle utilise une architecture mixture-of-experts de 80 milliards de paramètres — le plus grand MoE open-source de génération d’images à ce jour — et constitue un choix pratique pour les développeurs qui ont besoin d’un rendu de texte multilingue performant, d’un suivi précis des instructions et d’un dimensionnement flexible des sorties, à 0,10 $ par image. Ce guide couvre les points forts du modèle, comment l’intégrer et où il s’insère dans un pipeline d’images de production.

Points essentiels

• Le Hunyuan Image 3 est disponible sur Novita AI à l’endpoint POST https://api.novita.ai/v3/async/hunyuan-image-3, au tarif de 0,10 $/image (vérifié le 06/07/2026).
• Le modèle utilise une architecture MoE 80B (13B paramètres actifs par jeton) avec un cadre de génération unifié autorégressif.
• Il prend nativement en charge les instructions en chinois et en anglais avec un rendu de texte intégré à l’image de haute qualité.
• L’API est asynchrone : vous soumettez une requête, recevez un task_id, puis interrogez l’API de résultat de tâche pour obtenir la sortie.
• Cas d’usage pratique : scènes multilingues complexes, images contenant du texte, et pipelines nécessitant une interprétation d’instructions de niveau raisonnement.

Qu’est-ce que Hunyuan Image 3 ?

Hunyuan Image 3 (HunyuanImage 3.0) est le modèle de texte-à-image de troisième génération de Tencent, open-sourcé en septembre 2025. Contrairement à la plupart des modèles de génération d’images basés sur l’architecture diffusion transformer (DiT), Hunyuan Image 3 utilise un cadre autorégressif unifié qui traite la génération de texte et d’images comme un seul problème de modélisation — la même approche architecturale que celle utilisée dans les grands modèles de langage.

Le résultat est un modèle qui raisonne sur le contenu de l’image avant de la générer, en utilisant un schéma de chaîne de pensée avec des « jetons de réflexion » pour interpréter des instructions laconiques ou ambiguës, déduire les détails manquants et produire des sorties qui correspondent à l’intention plutôt qu’à la simple fréquence des jetons.

Faits clés sur l’architecture (source : rapport technique HunyuanImage 3.0, arXiv 2509.23951, septembre 2025) :

• 80B paramètres totaux, 64 experts, ~13B paramètres activés par jeton
• Cadre multimodale unifié autorégressif (non basé sur DiT)
• Raisonnement par chaîne de pensée via des jetons de réflexion
• Post-entraînement par apprentissage par renforcement pour l’alignement des instructions
• Support natif du chinois et de l’anglais

Comparé à Hunyuan Image 2.1, la version 3.0 montre une amélioration relative du taux de victoire de 14,1 % dans l’évaluation humaine professionnelle sur la qualité d’image et l’alignement du texte.

Accès à l’API Hunyuan Image 3 sur Novita AI

Novita AI héberge Hunyuan Image 3 en tant qu’API de tâche asynchrone. Le workflow est :

1. POST d’une requête de génération vers https://api.novita.ai/v3/async/hunyuan-image-3
2. Réception d’un task_id dans la réponse
3. Interrogation de https://api.novita.ai/v3/async/task-result avec le task_id jusqu’à ce que le statut de la tâche soit TASK_STATUS_SUCCEED
4. Extraction de l’URL de l’image à partir du résultat

Obtenez votre clé API depuis la console Novita AI. Les nouveaux comptes reçoivent 1 $ de crédits gratuits.

Spécifications et résumé des tarifs de Hunyuan Image 3

Champ	Détails	Source / Date de vérification
Nom d’affichage	Hunyuan Image 3	Documentation Novita AI / 06/07/2026
Endpoint	/v3/async/hunyuan-image-3	Documentation Novita AI / 06/07/2026
URL de base	https://api.novita.ai	Documentation Novita AI / 06/07/2026
Architecture	MoE 80B, autorégressif, 13B actifs	arXiv 2509.23951 / sept. 2025
Langues supportées	Anglais, Chinois	Dépôt Tencent HunyuanImage-3.0 / sept. 2025
Format de sortie	JPEG (par défaut)	Documentation Novita AI / 06/07/2026
Tarif	0,10 $ par image	novita.ai/models / 06/07/2026
Type d’API	Asynchrone (soumission + interrogation)	Documentation Novita AI / 06/07/2026
Meilleur usage	Scènes multilingues, images riches en texte, interprétation complexe d’instructions	Jugement

Principales capacités pour les développeurs

Raisonnement sur les instructions. Le mécanisme de chaîne de pensée permet au modèle de prendre une instruction courte comme « une photo de produit pour une marque de thé japonais haut de gamme » et de l’enrichir avec un contexte visuel approprié — éclairage, composition, indices de style — sans nécessiter une instruction longue et détaillée. Ceci est utile pour les pipelines où les instructions proviennent d’utilisateurs finaux plutôt que d’ingénieurs de prompt.

Rendu de texte. Hunyuan Image 3 gère le texte intégré à l’image en chinois et en anglais nettement mieux que la plupart des modèles T2I open-source. Si votre cas d’utilisation implique la génération d’images avec des panneaux lisibles, des étiquettes, des maquettes d’interface utilisateur ou du contenu localisé, c’est l’un des rares modèles pour lesquels vous n’avez pas besoin d’une étape de post-traitement distincte pour le texte.

Dimensionnement flexible. L’API accepte un paramètre size sous la forme width*height, couvrant une large gamme de rapports d’aspect pour le web, les réseaux sociaux et l’impression.

Pipelines bilingues. Les instructions en chinois génèrent un contenu approprié sans artefacts de romanisation ni surcoût de traduction. Utile pour les applications ciblant un public chinois.

Quand utiliser Hunyuan Image 3

• Vos instructions sont courtes ou fournies par l’utilisateur et nécessitent une élaboration intelligente avant la génération
• Vous avez besoin d’un texte lisible en chinois ou en anglais rendu dans l’image
• Vous générez des supports marketing localisés, des images de produits ou des visuels éditoriaux
• Vos instructions décrivent des scènes complexes avec de multiples éléments sémantiques nécessitant une composition cohérente

Quand ne pas utiliser Hunyuan Image 3

• Vous avez besoin du coût le plus bas par image : à 0,10 $/image, des alternatives comme Qwen Image sur Novita AI (0,02 $/image) ou Seedream 3.0 (0,03 $/image) sont nettement moins chères pour les pipelines à grand volume où le rendu de texte et le raisonnement ne sont pas critiques.
• Vous avez besoin d’édition d’image ou d’inpainting : Hunyuan Image 3 est uniquement texte-à-image. Pour les workflows d’édition d’image, utilisez un modèle d’édition dédié.
• Vous avez besoin de temps de réponse inférieurs à la seconde : l’architecture asynchrone ajoute une latence due à l’interrogation. Il n’est pas adapté aux applications interactives en temps réel.

Démarrage rapide avec l’API

Python

import requests
import time

API_KEY = "VOTRE_CLE_API_NOVITA"
BASE_URL = "https://api.novita.ai"

def generate_image(prompt: str, size: str = "1024*1024", seed: int = -1) -> str:
    # Soumettre la requête de génération
    response = requests.post(
        f"{BASE_URL}/v3/async/hunyuan-image-3",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json",
        },
        json={
            "prompt": prompt,
            "size": size,
            "seed": seed,
        },
    )
    response.raise_for_status()
    task_id = response.json()["task_id"]

    # Interroger pour le résultat
    while True:
        result = requests.get(
            f"{BASE_URL}/v3/async/task-result",
            headers={"Authorization": f"Bearer {API_KEY}"},
            params={"task_id": task_id},
        )
        result.raise_for_status()
        data = result.json()
        status = data.get("task", {}).get("status")
        if status == "TASK_STATUS_SUCCEED":
            return data["images"][0]["image_url"]
        elif status == "TASK_STATUS_FAILED":
            raise RuntimeError(f"Génération échouée : {data}")
        time.sleep(2)

image_url = generate_image(
    prompt="Une photo minimaliste de produit d'une boîte de matcha japonais premium sur une surface de marbre blanc, éclairage studio",
    size="1024*1024",
)
print(image_url)

cURL

# Étape 1 : Soumettre la requête
curl -s -X POST https://api.novita.ai/v3/async/hunyuan-image-3 \
  -H "Authorization: Bearer $NOVITA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Un stand de nourriture de rue éclairé au néon à Hong Kong la nuit, cinématographique, reflets de pluie",
    "size": "1280*720",
    "seed": -1
  }'

# Retourne : {"task_id": "..."}

# Étape 2 : Interroger pour le résultat
curl -s "https://api.novita.ai/v3/async/task-result?task_id=VOTRE_TASK_ID" \
  -H "Authorization: Bearer $NOVITA_API_KEY"

Paramètres de la requête

Paramètre	Type	Obligatoire	Notes
prompt	string	Oui	Description textuelle de l’image. Supporte l’anglais et le chinois.
size	string	Non	Dimensions de sortie sous forme width*height (ex. "1024*1024", "1280*720", "768*1024")
seed	integer	Non	-1 pour aléatoire ; définir une valeur fixe pour reproduire les résultats

Valeurs du statut du résultat de la tâche

Statut	Signification
TASK_STATUS_QUEUED	Requête reçue, en attente d’exécution
TASK_STATUS_RUNNING	Génération en cours
TASK_STATUS_SUCCEED	Terminée — URL de l’image disponible dans images[0].image_url
TASK_STATUS_FAILED	Génération échouée

Comment Hunyuan Image 3 s’intègre dans votre workflow API

Le modèle asynchrone utilisé par Hunyuan Image 3 sur Novita AI est le même que celui des autres points de terminaison de génération d’images et de vidéos sur la plateforme — soumettre une tâche, recevoir un task_id, interroger pour les résultats. Si vous utilisez déjà FLUX.1 Dev sur Novita AI ou la famille Kontext, passer à Hunyuan Image 3 nécessite simplement de changer l’endpoint et de mettre à jour le corps de la requête.

Une différence pratique : Hunyuan Image 3 prend un corps de requête plat (prompt, size, seed) plutôt que des objets input/parameters imbriqués. Consultez la documentation Novita AI pour le schéma canonique avant l’intégration.

Recommandation finale

Hunyuan Image 3 est le bon choix sur Novita AI lorsque le raisonnement sur les instructions, le rendu de texte multilingue ou la composition de scènes complexes sont plus importants que le coût. À 0,10 $/image, il est positionné dans la fourchette haute du catalogue d’images Novita AI — environ 3× Seedream 3.0 et 5× Qwen Image — mais il offre une capacité nettement différente : le modèle interprète les instructions laconiques, génère du texte lisible en chinois et en anglais dans les images, et gère des scènes sémantiquement denses où les modèles plus simples tendent à produire des compositions incohérentes.

Pour la génération d’images à grand volume et à faible coût, des alternatives moins chères constituent un meilleur point de départ. Pour les workflows de production où la qualité d’image, la précision du texte ou le contenu bilingue sont des exigences, Hunyuan Image 3 vaut la différence de prix.

FAQ

Quel est l’endpoint Novita AI pour Hunyuan Image 3 ?

POST https://api.novita.ai/v3/async/hunyuan-image-3. L’API est asynchrone — vous soumettez une requête, recevez un task_id, puis interrogez /v3/async/task-result jusqu’à ce que le statut soit TASK_STATUS_SUCCEED.

Combien coûte Hunyuan Image 3 sur Novita AI ?

0,10 $ par image au 06/07/2026 (source : novita.ai/models). Vérifiez les tarifs en vigueur sur la page de tarification Novita AI avant de construire un modèle de coût pour les charges de travail de production.

Qu’est-ce qui rend Hunyuan Image 3 différent de FLUX.1 ou Stable Diffusion ?

Hunyuan Image 3 utilise un cadre multimodale unifié autorégressif plutôt que l’architecture diffusion transformer (DiT) utilisée par FLUX.1 et la plupart des variantes de Stable Diffusion. L’effet pratique est un raisonnement plus fort sur les instructions via des jetons de réflexion de chaîne de pensée, un meilleur rendu de texte multilingue et une gestion plus cohérente des scènes complexes à plusieurs éléments.

Hunyuan Image 3 prend-il en charge l’édition d’image ou l’inpainting ?

Non. Le modèle sur Novita AI est uniquement texte-à-image. Pour l’édition d’image, utilisez un modèle d’édition dédié tel que FLUX.1 Kontext ou Qwen-Image-Edit.

Puis-je utiliser des instructions en chinois avec Hunyuan Image 3 ?

Oui. Le modèle prend nativement en charge les instructions en chinois et en anglais. Les instructions en chinois génèrent un contenu visuel approprié sans artefacts de traduction.

Comment reproduire une sortie d’image spécifique ?

Définissez le paramètre seed sur une valeur entière fixe. La même combinaison de seed, prompt et size reproduira la même image.

Articles recommandés

• Exécutez FLUX.1 [dev] sur Novita AI : Transformez le texte en visuels
• Qwen Image sur Novita AI
• FLUX.1 Kontext Pro vs Max vs Dev sur Novita AI