Tripo
Tripo H3.1
tripo-h3.1/multiview-to-3d
Modèle de génération 3D haute définition de Tripo, capable de générer des assets 3D texturés à partir d'invites textuelles, d'une seule image ou de plusieurs vues, avec un nombre de faces et une qualité de texture ajustables et une sortie en matériaux PBR, adapté à la création d'assets tels que des objets de jeu ou de la visualisation produit
Essayer tripo-h3.1/multiview-to-3d
Entrée
Téléversez dans l'ordre les différentes vues d'un même objet : face (obligatoire), gauche, arrière, droite, avec au minimum 2 et au maximum 4 images ; seuls les formats JPG, PNG et WEBP sont pris en charge.
Sortie
Tarifs
tripo-h3.1/multiview-to-3d per model
+ $0.290 géométrie plus fine · si détaillée est sélectionné
Présentation
Outil de génération de modèles 3D à partir de vues multiples : il reçoit 2 à 4 images d'un même objet sous différents angles et produit un actif 3D doté d'une structure géométrique. Les images d'entrée sont fournies dans l'ordre avant, gauche, arrière, droite ; il convient aux professionnels de l'art de jeu et de la visualisation produit disposant de photos de produit ou de prises de vue circulaires, qui peuvent ainsi convertir rapidement un objet réel ou une maquette en un modèle 3D qu'il reste possible d'éditer, de rendre ou d'exporter.
Points clés
- Géométrie contrainte par vues multiples — la modélisation peut s'appuyer sur 2 à 4 images d'un même objet sous des angles différents, ce qui contraint le contour de façon plus complète qu'une image unique.
- Finesse géométrique et de texture réglable — la qualité géométrique et la qualité de texture disposent chacune de deux niveaux, standard ou détaillé (standard / detailed), permettant d'arbitrer entre rapidité et détail selon l'usage.
- Contrôle souple des matériaux et du nombre de faces — les textures et les matériaux PBR peuvent être activés ou désactivés, et un nombre cible de triangles de 1 000 à 1,5 million (2 millions en géométrie détaillée) peut être spécifié.
- Contrôle du style et de la reproductibilité — l'orientation peut être alignée sur les images d'entrée, et la géométrie comme la texture disposent chacune d'une graine aléatoire, ce qui facilite la fixation des résultats.
Fonctionnalités
Modélisation à partir de vues multiples : fournir 2 à 4 images HTTPS décrivant le même objet dans l'ordre avant, gauche, arrière, droite pour générer l'actif 3D correspondant.
Textures et matériaux PBR : les textures et les matériaux PBR sont générés par défaut ; il est possible de désactiver simultanément textures et PBR pour ne conserver qu'un maillage purement géométrique ; la qualité de texture est réglable sur standard ou détaillé.
Contrôle du nombre maximal de faces : un nombre cible de triangles de 1 000 à 1,5 million (2 millions en géométrie détaillée) peut être spécifié ; s'il n'est pas renseigné, le modèle le détermine de façon adaptative, ce qui facilite l'adéquation au budget du pipeline en aval.
Orientation et alignement : lorsque l'orientation « aligner sur l'image d'entrée » (align_image) est choisie, le modèle effectue une rotation automatique pour correspondre aux images d'entrée ; l'alignement de texture (texture_alignment) permet de choisir entre un ajustement à l'image d'origine ou à la géométrie.
Reproductibilité par graine aléatoire : des graines entières sont définies séparément pour la géométrie et la texture, ce qui aide à reproduire le résultat de génération avec les mêmes entrées et les mêmes réglages.
Cas d'usage
- Conversion de photos de produit en prises de vue circulaires en actifs 3D — les équipes e-commerce ou produit utilisent des photos de produit sous plusieurs angles comme entrée pour obtenir un modèle 3D texturé, destiné à une présentation 3D sur le web ou à des visuels marketing.
- Prototypes d'art de jeu et de décor — les artistes génèrent, à partir de maquettes multi-vues de personnages ou d'accessoires, un maillage à nombre de faces moyen, puis l'importent dans le moteur comme accessoire de premier plan ou actif de validation de concept.
- Organisation de scans et référence de retopologie — les équipes d'actifs numériques génèrent, à partir d'images de scan multi-vues, un modèle de référence texturé qui sert de base de comparaison pour une reconstruction manuelle ou la création de matériaux.
Limites et conseils de choix
Les images doivent être des adresses HTTPS et chaque requête doit fournir 2 à 4 vues du même objet ; en deçà ou au-delà de cette plage, la soumission est impossible. Le nombre cible de triangles est limité entre 1 000 et 1,5 million (2 millions en géométrie détaillée), et plus le nombre de faces est élevé, plus les performances requises pour le traitement ultérieur augmentent. Les textures et les matériaux PBR peuvent être désactivés simultanément, auquel cas seul un maillage purement géométrique est produit ; le niveau détaillé (detailed) ajoute du détail mais allonge le temps de traitement. La graine aléatoire ne fait qu'aider à la reproduction et ne garantit pas des générations strictement identiques d'une fois sur l'autre.
Nouveautés
Voir le journal des modifications →- Nouveau modèle tripo-h3.1/multiview-to-3d désormais disponible : génération 3D multi-vues avec Tripo H3.1
- Nouveau modèle tripo-h3.1/text-to-3d est disponible : génération 3D à partir de texte avec Tripo H3.1
- Nouveau modèle tripo-h3.1/image-to-3d désormais disponible : Tripo H3.1 image vers 3D
Questions fréquentes
Voir toutes les questions →-
Quelle est la limite maximale du nombre de faces, peut-elle atteindre 2 millions ?
Oui, la limite de face_limit est de 2 millions de triangles, mais la prise en charge réelle jusqu'à 2 millions n'est assurée que lorsque geometry_quality est défini sur detailed ; en mode standard, il est recommandé de rester sous 1,5 million. Si face_limit n'est pas transmis, le modèle détermine automatiquement le nombre de faces.
-
Comment obtenir d'abord un simple géométrie sans texture ?
Il suffit de définir texture et pbr sur false ; lorsque pbr vaut true, la génération de textures est forcée. Si vous voulez des textures mais pas de matériau PBR, définissez texture sur true et pbr sur false.
-
Faut-il activer un paramètre distinct pour la géométrie haute densité ?
Définir geometry_quality sur detailed ajoute des détails de maillage plus fins, et constitue également la condition préalable pour atteindre 2 millions de faces ; si vous avez besoin de textures plus fines, définissez texture_quality sur detailed. Les deux sont par défaut sur standard ; activez-les selon les exigences de gros plan de l'actif cible.
-
Comment reproduire les résultats de génération pour faciliter la comparaison de différents paramètres ?
La géométrie et les textures disposent chacune d'une graine fixe : model_seed contrôle la géométrie, texture_seed contrôle les textures, et la génération 3D à partir de texte possède en plus image_seed qui contrôle l'image conceptuelle. Lors de comparaisons de réglages, fixez d'abord les graines et ne modifiez qu'un seul paramètre à la fois, afin de pouvoir déterminer de quel élément provient la différence.
Créer une tâche de génération
https://api.hiapi.ai/v1/tasks En-têtes
AuthorizationstringRequisClé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API
Content-TypestringOptionnelLe corps de la requête est toujours analysé en JSON ; s'il est envoyé, seul application/json (charset facultatif) est accepté — toute autre valeur renvoie 415. Exemple : application/json.
Idempotency-KeystringOptionnelClé d'idempotence, jusqu'à 255 octets. Les reprises avec la même clé du même compte ne créent la tâche qu'une seule fois ; les rejeux renvoient le taskId d'origine.
En cas de timeout réseau ou de relance automatique du client, la même clé ne crée la tâche qu'une seule fois, sans double facturation (portée = le compte de la clé API). Utilisez un identifiant métier unique (ex. "order-42") ; les rejeux renvoient le taskId d'origine et les clés expirent 24 h après la première requête. La matrice complète des scénarios est dans la présentation de l'API asynchrone unifiée.
Corps
modelstringRequisValeur fixe actuelle : tripo-h3.1/multiview-to-3d
routestringOptionnelValeur fixe actuelle : default
inputobjectRequis
Objet de paramètres métier pour tripo-h3.1/multiview-to-3d et la route default — voir le tableau des paramètres ci-dessous.
pbrbooleanOptionnelDéfaut: trueIndique s'il faut générer des textures de matériau PBR ; si true, des textures sont également produites, valeur par défaut true.
texturebooleanOptionnelDéfaut: trueIndique s'il faut générer des textures pour le modèle, valeur par défaut true. À noter que si pbr vaut true, la génération de textures est forcée ; seul le réglage de texture et pbr tous deux sur false produit un maillage purement géométrique.
face_limitintegerOptionnelmin 1000max 2000000Nombre cible de triangles, en nombre entier, plage 1000–1500000 (jusqu'à 2000000 lorsque geometry_quality=detailed) ; si omis, le modèle détermine automatiquement le nombre de faces ; le fichier est généralement volumineux, une valeur d'environ 50000 est recommandée pour un affichage web.
image_urlsarrayRequisminItems 2maxItems 4Tableau d'URL HTTPS de 2 à 4 images de vues du même objet, dans l'ordre face, gauche, arrière, droite ; la première doit être la face avant.
Array [ string ]
model_seedintegerOptionnelGraine aléatoire pour la génération de la géométrie, en nombre entier, permettant de reproduire le même résultat géométrique.
orientationstringOptionnelDéfaut: "default"Réglage de l'orientation du modèle, en chaîne de caractères ; réglé sur align_image, le modèle pivote automatiquement pour s'aligner sur l'image d'entrée, valeur par défaut default.
defaultalign_imagetexture_seedintegerOptionnelGraine aléatoire pour la génération des textures, en nombre entier, permettant de reproduire le même résultat de texture.
texture_qualitystringOptionnelDéfaut: "standard"Niveau de qualité des textures, en chaîne de caractères ; le niveau detailed génère des textures de plus haute résolution, valeur par défaut standard.
standarddetailedgeometry_qualitystringOptionnelDéfaut: "standard"Niveau de qualité de la géométrie, en chaîne de caractères ; le niveau detailed offre des détails de maillage plus fins, valeur par défaut standard.
standarddetailedtexture_alignmentstringOptionnelDéfaut: "original_image"Mode d'alignement des textures sur l'image d'entrée, en chaîne de caractères, valeur par défaut original_image.
original_imagegeometrycallbackobjectOptionnel
Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.
Fournissez callback.url à la création et HiAPI envoie un POST à votre service à l'état terminal — plus besoin de polling. Le corps du rappel reprend la structure du détail de tâche ; vérification de signature, relances et idempotence sont décrits dans la présentation de l'API asynchrone unifiée.
urlstringRequisObligatoire si callback est présent. Un POST est envoyé vers cette URL à l'état terminal ; doit être une URL http(s) valide.
whenstringOptionnelDéfaut: "final"Seul final est pris en charge pour l'instant — notifié sur success et fail.
finalstoragestringOptionnelDéfaut: "temp"Niveau de stockage des artefacts : temp (par défaut, ~7 jours) ou persistent (long terme, facturé au volume). Solde insuffisant ou dépassement de limite ⇒ rétrogradation silencieuse en temp ; le niveau effectif figure dans la réponse de détail.
temppersistentExemples de requête
# Soumet une tâche asynchrone ; renvoie immédiatement un taskId (n'attend pas la génération)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tripo-h3.1/multiview-to-3d",
"input": {
"pbr": true,
"texture": true,
"image_urls": "…",
"orientation": "default",
"texture_quality": "standard",
"geometry_quality": "standard",
"texture_alignment": "original_image"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "tripo-h3.1/multiview-to-3d",
input: {
"pbr": true,
"texture": true,
"image_urls": "…",
"orientation": "default",
"texture_quality": "standard",
"geometry_quality": "standard",
"texture_alignment": "original_image"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "tripo-h3.1/multiview-to-3d",
"input": {
"pbr": True,
"texture": True,
"image_urls": "…",
"orientation": "default",
"texture_quality": "standard",
"geometry_quality": "standard",
"texture_alignment": "original_image"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Obtenir le détail de la tâche
https://api.hiapi.ai/v1/tasks/:id Champs de réponse
taskIdstringRequisIdentifiant de tâche, toujours préfixé tk-hiapi-.
modelstringRequisNom complet résolu du modèle. Les tâches envoyées avec le paramètre route renvoient base@route (ex. gpt-image-2/text-to-image@ext) ; sinon identique au nom fourni.
routestringOptionnelPrésent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.
statusstringRequisStatut de la tâche.
queued En file, pas encore démarrée.
handling En cours de traitement.
archiving Traitement terminé, préparation des artefacts.
success Terminal : terminé, artefacts disponibles (output renvoyé).
fail Terminal : échec (error renvoyé).
Après soumission, suivez status : success et fail sont terminaux, le reste non terminal. Interrogez toutes les 1–3 s jusqu'à l'état terminal. En cas de succès, téléchargez les artefacts via output[].url et transférez-les avant expireAt ; pour une conservation longue durée, indiquez storage: "persistent" à la création.
creatednumberRequisDate de création de la tâche (secondes Unix).
completednumberRequisSecondes Unix de l'état terminal ; 0 tant que non terminal.
outputarrayOptionnel
Présent uniquement si status == success. Liste d'artefacts — toujours un tableau ; une tâche peut renvoyer plusieurs types à la fois (ex. video + first_frame).
Array [ object ]
Éléments du tableau
urlstringRequisURL de l'artefact, téléchargeable directement.
typestringRequisValeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.
expireAtnumberRequisSecondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.
errorobjectOptionnel
Présent uniquement si status == fail.
codestringRequisCode d'erreur métier.
messagestringRequisDescription de l'erreur.
Exemples de réponse
Succès
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} En cours (non terminal)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Échec
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Articles
Voir tous les articles →-
Comparatif et évaluation
Comparatif et guide de sélection Tripo H3.1 : comment choisir entre trois parcours de génération 3D et comment économiser
Un compromis tarifaire et capacitaire pour les développeurs, à partir de la forme d'entrée, du raffinement géométrique et des commutateurs PBR/texture
-
Tutoriel
Cas d'usage concrets de Tripo H3.1 : 5 usages à forte valeur et points clés de mise en œuvre
Du texte-vers-3D à la reconstruction multi-vues : choisir le bon mode et les bons paramètres selon le cas d'usage
-
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