Blog

Guide d'utilisation

Guide de prise en main de Tripo H3.1 : trois modes d'entrée, paramètres et choix tarifaires

Décision d'intégration et maîtrise des coûts de la génération 3D pour les développeurs

Nov 20, 2026
Image de couverture abstraite de plans géométriques en béton sous une lumière rasante, fond gris avec ombres bleu ardoise et fines jointures couleur sauge.
Sur cette page

Ce que Tripo H3.1 sait faire, et où sont ses limites

Tripo H3.1 est un modèle de génération 3D, exposé via l'interface unifiée de HiAPI.ai, appelable avec une simple clé API. Il prend en charge trois formes d'entrée : une description en langage naturel (text-to-3D), une seule image d'objet (image-to-3D), et 2 à 4 images multi-vues du même objet (multiview-to-3D).

La sortie est un ensemble de livrables fixe : un fichier de modèle GLB + une image d'aperçu. Pas de pack de textures de matériaux supplémentaire, pas de fichier de projet, pas de squelette ni d'animation. Le GLB est un format universel : une fois obtenu, il s'importe directement dans Blender, Three.js, Unity ou tout pipeline prenant en charge glTF.

Les limites doivent aussi être clairement énoncées :

  • C'est de la génération au niveau de l'objet, pas de la scène. Fournissez l'image d'une chaise et vous obtiendrez une chaise, pas une pièce avec une chaise à l'intérieur. Pour une scène, composez vous-même plusieurs modèles.
  • Il ne comprend pas les « actions ». Les actifs statiques sont son terrain de prédilection ; le rigging, le skinning et les séquences d'animation sortent de son périmètre.
  • La qualité du matériau source est le plafond de la sortie. Des images d'entrée floues, contenant plusieurs objets ou avec des occlusions complexes dégradent nettement la qualité géométrique, et cela vaut pour les trois modes.
  • La facturation est à l'appel : un appel produit un modèle, sans état intermédiaire facturé au token ou à la seconde. Cette caractéristique est un avantage pour l'estimation des coûts — le nombre d'appels est l'unité de facturation.

Une fois ce périmètre compris, les choix qui suivent prennent tout leur sens : les trois modes ne sont pas trois portes d'entrée vers la même chose, leurs prix unitaires, leurs exigences de matériau et leurs cas d'usage diffèrent.

Trois types d'entrée se resserrent via un même entonnoir vers un modèle unique et une sortie d'aperçu ; les limites apparaissent aussi à cet endroit de convergence.

Comment choisir parmi les trois modes d'entrée

Le premier principe de choix n'est pas « lequel donne le meilleur résultat », mais de quel matériau vous disposez.

Seulement une description textuelle → text-to-3D. Adapté à l'exploration conceptuelle, aux actifs de remplissage, aux prototypes précoces. Vous contrôlez entièrement la direction de génération, mais vous assumez aussi toute l'incertitude : l'inférence du modèle sur le nombre de faces et la forme provient intégralement de vos mots-clés. C'est le palier tarifaire le plus bas, adapté aux essais massifs.

Une image produit ou une photo d'objet propre → image-to-3D. C'est le mode que la grande majorité des développeurs emprunteront en pratique. Une image de face avec un fond propre apporte bien plus d'information qu'une description textuelle, et la fidélité géométrique est nettement plus stable. L'exigence de matériau n'est pas élevée : une photo et un détourage de fond suffisent.

2 à 4 images sous différents angles → multiview-to-3D. Lorsque vous disposez déjà de matériaux multi-angles (par exemple les quatre vues standard d'un studio photo produit, ou des images de plateau tournant rendues à partir d'un actif 3D existant), le multi-vues offre le plus haut niveau de précision. Il résout le problème structurel du « verso deviné » de la génération à partir d'une seule image.

Un fait tarifaire notable : image-to-3D et multiview-to-3D sont au même prix, le text-to-3D est moins cher. Donc, à condition d'avoir les matériaux, le multi-vues n'entraîne aucun surcoût — si vous avez les matériaux, utilisez le multi-vues, il n'y a aucune raison de revenir à une seule image.

La décision peut se résumer en une phrase : assez de matériaux pour le multi-vues → multi-vues ; une bonne image → image-to-3D ; rien du tout → text-to-3D.

Paramètres d'entrée et préparation des matériaux

Les champs d'entrée des trois modes diffèrent ; les mélanger échoue directement.

Text-to-3D (page du modèle) reçoit une description en langage naturel. La clé d'un bon prompt est la précision : le type d'objet, la tendance du matériau, les caractéristiques de forme sont plus efficaces que l'accumulation d'adjectifs.

Image-to-3D (page du modèle) utilise image_url, une image HTTPS. Exigences sur le matériau :

  • Un seul objet, pas plusieurs objets dans le même cadre
  • Fond propre, éviter les environnements encombrés de la même couleur que le sujet
  • Le sujet doit occuper autant que possible l'image
  • L'URL doit être accessible publiquement (HTTPS), ne pas envoyer d'adresse privée nécessitant une authentification

Multiview-to-3D (page du modèle) utilise image_urls, 2 à 4 images du même objet, dans l'ordre fixe avant, gauche, arrière, droite. Un ordre incorrect est l'une des sources d'échec les plus fréquentes : le modèle suppose le point de vue selon la position, et placer une image au mauvais endroit revient à lui donner une contrainte géométrique erronée.

Deux conseils généraux pour la préparation des matériaux. Premièrement, les images multi-vues doivent autant que possible conserver un éclairage et une échelle cohérents ; mélanger des photos de sources différentes crée des ambiguïtés aux jointures du modèle. Deuxièmement, la résolution des images n'a pas besoin d'être maximale : la netteté et la clarté du sujet importent plus que le nombre de pixels.

Les requêtes aux paramètres invalides (champ manquant, format d'URL incorrect, nombre de vues hors limites) sont directement rejetées et ne sont pas facturées — point que nous réutiliserons dans la checklist de débogage de la section suivante.

face_limit et qualité géométrique : contrôler la complexité du modèle

face_limit est le paramètre central pour contrôler le nombre de faces en sortie, avec une plage de 1000–1 500 000 ; lorsque geometry_quality est réglé sur detailed, la limite supérieure est portée à 2 000 000.

La conception clé est la suivante : ce paramètre peut être omis. Lorsqu'il est omis, le modèle détermine automatiquement le nombre de faces, généralement une valeur raisonnable correspondant à la complexité de l'objet. Ne le spécifiez manuellement que lorsque vous connaissez précisément le budget de faces en aval :

  • Rendu temps réel mobile ou Web : palier plutôt bas, se limiter à quelques dizaines de milliers de faces
  • Actifs de plan moyen dans un jeu : palier intermédiaire
  • Niveau cinéma ou rendu hors ligne : proche de la limite, avec une géométrie fine

geometry_quality a deux valeurs : standard (géométrie standard, par défaut) et detailed (géométrie fine). detailed apporte plus de détails géométriques et une limite de faces plus élevée, mais c'est une option facturée en supplément, sur les trois modes. Le critère est direct : ne l'activez que si l'actif sera observé de près ou si le détail est lui-même un argument ; activer detailed pour un actif d'arrière-plan ou de remplissage est un pur gaspillage.

Conseil pratique pour combiner les deux : exécutez d'abord une version avec la configuration par défaut (face_limit omis, geometry_quality en standard) pour voir le résultat, puis ajustez les paramètres pour l'actif concerné. Ne poussez pas tous les paramètres au maximum dès le départ : vous dépenseriez plus et n'obtiendriez pas nécessairement un meilleur résultat.

Décomposition de la structure tarifaire : où va l'argent

Tripo H3.1 facture à l'appel, chaque appel produisant un modèle + une image d'aperçu. Le prix est déterminé par quatre variables : le mode d'entrée, l'option Texture, l'option PBR, la qualité géométrique. Une fois cette structure comprise, choisissez votre palier à partir du tarif catalogue complet ci-dessous.

Les tarifs actuels de l'environnement de test sont les suivants, à l'appel, par modèle, en USD.

Text-to-3D (tripo-h3.1/text-to-3d)

SpécificationTexture standardTexture fine
PBR désactivé · Texture désactivée$0.150$0.150
PBR désactivé · Texture activée$0.290$0.430
PBR activé$0.290$0.430

Image-to-3D (tripo-h3.1/image-to-3d) et multiview-to-3D (tripo-h3.1/multiview-to-3d) au même prix

SpécificationTexture standardTexture fine
PBR désactivé · Texture désactivée$0.290$0.290
PBR désactivé · Texture activée$0.430$0.580
PBR activé$0.430$0.580

Pour chacun des paliers ci-dessus, la sélection d'une géométrie fine ajoute $0.290.

Premier niveau : le mode d'entrée. Le palier de départ du text-to-3D est le plus bas ; image-to-3D et multi-vues sont au même prix, plus élevé que le text-to-3D. C'est intuitif : l'image-to-3D et le multi-vues apportent plus d'information, et le modèle fournit plus de travail.

Deuxième niveau : les options Texture et PBR, principaux amplificateurs de prix. Les deux options désactivées correspondent au palier de base ; activer Texture fait monter le prix unitaire d'un cran ; activer PBR le place au même palier ou plus haut. Autrement dit, pour un actif complet passant de « géométrie pure » à « texture + PBR », le prix unitaire peut plus que doubler. C'est la variable de prix la plus importante du tableau, bien plus significative que les différences de mode d'entrée.

Troisième niveau : la finesse de texture. Avec la texture activée, texture standard et texture fine ont deux prix distincts. La surprime de la texture fine est particulièrement marquée sur le mode text-to-3D.

Quatrième niveau : la qualité géométrique. Choisir detailed (géométrie fine) entraîne un supplément au-dessus des prix ci-dessus, identique sur les trois modes.

On en tire quelques règles de décision tarifaire :

  • Si l'aval n'a besoin que de la géométrie (par exemple pour un collider ou un modèle de base à texturer manuellement ensuite), désactivez Texture et PBR : le prix unitaire retombe immédiatement au palier le plus bas.
  • Pour une simple validation de prototype, text-to-3D avec toutes les options désactivées est la combinaison la plus économique.
  • Ce qui coûte réellement cher, c'est la livraison complète « texture fine + PBR + géométrie fine » avec les trois options activées : cela doit être une décision prise après confirmation de la mise en ligne de l'actif.
Comparaison empilée des trois paliers tarifaires : les options Texture et PBR agissent comme des plaques qui s'élèvent palier par palier, poussant le prix unitaire à la hausse étape par étape.

Configurations recommandées et estimation de coût pour les scénarios typiques

Passons de la structure à des combinaisons concrètes. Les scénarios ci-dessous sont exprimés à l'appel ; le coût réel s'accumule selon le nombre d'appels.

Prototypage et exploration conceptuelle

Text-to-3D, Texture désactivée et PBR désactivé, geometry_quality en standard, face_limit omis. C'est le palier le plus bas de tout le modèle, adapté à la génération de dizaines de directions pour un tri rapide. Une fois le tri effectué, relancez une version avec texture pour les candidats retenus.

Actifs e-commerce / présentation produit

Avec une image produit, utilisez l'image-to-3D ; si vous avez des matériaux quatre vues standard, utilisez le multi-vues. Texture activée, PBR activé (le PBR apporte une réelle valeur au rendu des matières, cela vaut la dépense pour un scénario de présentation), texture en standard, géométrie en standard. Si le produit doit être observé en gros plan, envisagez alors la texture fine.

Actifs de jeu / rendu temps réel

Image-to-3D ou multi-vues, Texture activée, PBR selon le pipeline de rendu (activez-le si le pipeline prend en charge le PBR). Définissez face_limit manuellement selon la plateforme cible, ne le laissez pas en adaptation automatique. Qualité géométrique en standard par défaut — en rendu temps réel, le gain de detailed ne se voit généralement pas.

Uniquement un modèle de base géométrique

N'importe quel mode, Texture et PBR désactivés, qualité géométrique selon les besoins. C'est la méthode pour réduire les coûts au minimum structurel, le texturing ultérieur étant confié au pipeline artistique.

Un rythme d'économie universel : validez d'abord la direction avec un palier bas, puis relancez les actifs confirmés avec le palier élevé. Ne payez pas le plein tarif pour chaque essai.

Checklist de débogage et de validation de l'intégration

Le mécanisme le plus important en phase d'intégration : les requêtes aux paramètres invalides sont directement rejetées et ne sont pas facturées. Cela signifie que vous pouvez essayer hardiment pendant le développement — une faute de frappe dans un nom de champ, un format d'URL incorrect, un nombre de vues hors limites coûtent une erreur, pas une facture. Profitez de cette caractéristique : validez d'abord la vérification des paramètres, puis parlez de résultats.

Checklist de validation avant mise en ligne :

  1. Accessibilité des URL : testez image_url / image_urls par une requête anonyme, vérifiez que l'accès en HTTPS se fait sans authentification. Le fait qu'elle s'ouvre en local ne garantit pas qu'elle soit accessible depuis l'Internet public.
  2. Ordre des vues multiples : vérifiez image par image s'il s'agit bien de avant, gauche, arrière, droite. C'est l'erreur silencieuse la plus fréquente — la requête réussit, mais le résultat se dégrade, et l'attribution est difficile.
  3. Nombre de vues : pour le multi-vues, restez strictement entre 2 et 4 images.
  4. Limites de face_limit : si spécifié manuellement, vérifiez qu'il est dans 1000–1 500 000 ; la limite supérieure n'est portée à 2 000 000 qu'avec detailed. Un dépassement est rejeté.
  5. Cohérence des options avec l'attendu : vérifiez que les options Texture / PBR correspondent au palier tarifaire prévu. C'est entre configuration par défaut et configuration finale que survient le plus souvent l'écart « on croyait désactivé mais c'était activé ».
  6. Validation de la sortie : chaque appel doit renvoyer un GLB et une image d'aperçu. Validez au niveau de la couche d'intégration que les deux sont présents avant de passer en aval.
  7. Stratégie de nouvelle tentative en cas d'échec : distinguez « paramètres rejetés » (modifiez les paramètres, ne réessayez pas) et « anomalie réseau/service » (nouvelle tentative possible), pour éviter de facturer à plusieurs reprises des requêtes vouées à l'échec.

En parcourant cette checklist, la grande majorité des problèmes d'intégration seront résolus avant la première mise en ligne.

Trois modes d'entrée correspondent à trois situations de matériaux, deux options déterminent l'ordre de grandeur du prix, et face_limit ne se touche que si vous avez un budget précis. En décidant dans cet ordre, l'intégration de Tripo H3.1 sera assez directe — il suffit de lancer le premier appel depuis la page du modèle.

Articles similaires

Voir tous les articles →

Commencez avec des artefacts IA persistants

Obtenez votre clé API et appelez des modèles d'image, de vidéo et d'audio via une API unique basée sur les tasks.

Lire la documentation de l'API