Tripo
Tripo H3.1
tripo-h3.1/image-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/image-to-3d
Entrée
Téléversez la photo d'un objet unique sur un fond propre comme entrée de génération ; seuls les formats JPG, PNG et WEBP sont pris en charge.
Sortie
Tarifs
tripo-h3.1/image-to-3d per model
+ $0.290 géométrie plus fine · si détaillée est sélectionné
Présentation
Destiné aux développeurs et aux équipes de design qui ont besoin de générer rapidement un bien tridimensionnel à partir d'une seule photo. Il suffit de fournir l'URL HTTPS d'une image d'objet sur fond propre pour obtenir un modèle 3D avec géométrie et textures facultatives ; idéal pour transformer rapidement la photo d'un objet réel en un actif numérique consultable, rendu ou éditable par la suite.
Points forts
- Génération d'un modèle 3D à partir d'une seule image — fournissez le lien d'une photo d'objet sur fond propre pour lancer la génération ; idéal pour numériser rapidement un objet réel ou un visuel de conception.
- Contrôle séparé de la géométrie et des textures — vous pouvez désactiver à la fois les textures et le PBR pour n'obtenir qu'un maillage géométrique, ou régler séparément le niveau de qualité de la géométrie et des textures selon l'usage visé.
- Plafond de faces configurable — vous pouvez spécifier un nombre cible de triangles entre 1 000 et 1,5 million (2 millions en géométrie détaillée), afin de l'adapter aux pipelines en aval de différentes précisions.
- Résultats reproductibles — une graine aléatoire peut être définie pour la géométrie comme pour les textures ; combinée à des paramètres fixes, elle facilite les générations répétées et la comparaison des résultats.
Description des capacités
Génération d'un maillage 3D à partir d'une image : saisissez le lien HTTPS d'une photo d'objet unique pour obtenir un modèle 3D ; si les textures et le PBR sont tous deux désactivés, seul un maillage purement géométrique est produit, ce qui convient pour définir d'abord la forme puis la retoucher.
Contrôle du nombre de faces cible : la limite de faces (face_limit) permet de fixer un nombre cible de triangles entre 1 000 et 1,5 million (2 millions en géométrie détaillée) ; si elle n'est pas renseignée, le modèle la détermine automatiquement, ce qui facilite l'adéquation aux besoins de précision du rendu ou des scènes allégées.
Activation des textures et du PBR : les textures sont activées par défaut et génèrent par défaut un matériau PBR ; l'activation du PBR force la génération des textures, et ce n'est que lorsque les textures et le PBR sont tous deux désactivés que seule la géométrie est conservée, selon l'usage en aval.
Choix du niveau de qualité : la qualité géométrique et la qualité des textures peuvent chacune être réglées sur standard ou détaillée (standard / detailed) ; le niveau détaillé apporte respectivement des détails de maillage plus fins et des textures de plus haute résolution.
Orientation et alignement des textures : l'option d'orientation (orientation) « aligner sur l'image d'entrée » (align_image) fait pivoter automatiquement le modèle pour correspondre à l'image d'entrée ; l'alignement des textures (texture_alignment) peut être réglé sur l'image d'origine ou sur la géométrie.
Cas d'usage
- Conversion de photos d'objets en actifs numériques — les équipes e-commerce ou de design génèrent un modèle 3D à partir de photos d'objets tenus à la main et l'intègrent à une page de présentation produit ou à une visionneuse 3D pour que les utilisateurs le fassent pivoter.
- Mise en volume rapide de concepts — les concepteurs transforment croquis ou images de référence en maillages 3D, puis les utilisent comme point de départ pour les proportions et les volumes dans un logiciel de modélisation.
- Base 3D pour supports marketing — les équipes marketing génèrent des modèles texturés à partir d'images produit, puis les importent dans un pipeline de rendu ou d'animation pour créer des visuels produit en volume.
- Prégénération d'actifs allégés — les développeurs définissent un nombre de faces réduit et des textures standard pour générer en lot des actifs 3D adaptés au mobile ou aux scènes temps réel.
Limites et conseils de sélection
L'entrée n'accepte que le lien HTTPS d'une image d'objet unique sur fond propre ; une image au fond encombré ou comportant plusieurs objets ne garantit pas une géométrie idéale. Le nombre de faces cible est limité entre 1 000 et 1,5 million (2 millions en géométrie détaillée) de triangles ; un nombre de faces faible entraîne une perte de détails. Une fois les textures et le PBR désactivés, la sortie est une géométrie sans matériau. L'alignement des textures et les réglages d'orientation influencent l'apparence finale et doivent être choisis en fonction de l'image d'entrée ; le résultat généré n'est pas garanti identique point par point à la photo.
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/image-to-3d
routestringOptionnelValeur fixe actuelle : default
inputobjectRequis
Objet de paramètres métier pour tripo-h3.1/image-to-3d et la route default — voir le tableau des paramètres ci-dessous.
pbrbooleanOptionnelDéfaut: trueContrôle si un matériau PBR est généré ; lorsqu'il est défini sur true, les textures sont également générées. 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 : lorsque pbr vaut true, la génération de textures est forcée ; seul un réglage de texture et pbr tous deux sur false produit un maillage purement géométrique.
image_urlstringRequispattern ^https://Adresse HTTPS d'une photo unique de l'objet, dont le fond doit être propre, utilisée comme image d'entrée pour la génération 3D à partir d'une image.
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, environ 50000 est recommandé pour un affichage web.
model_seedintegerOptionnelGraine aléatoire de génération géométrique, en nombre entier, permettant de reproduire le même résultat géométrique.
orientationstringOptionnelDéfaut: "default"Contrôle l'orientation du modèle ; align_image effectue une rotation automatique pour l'aligner sur l'image d'entrée. Valeur par défaut : default.
defaultalign_imagetexture_seedintegerOptionnelGraine aléatoire de génération de textures, en nombre entier, permettant de reproduire le même résultat de texture.
texture_qualitystringOptionnelDéfaut: "standard"Contrôle la qualité des textures ; detailed génère des textures de résolution plus élevée. Valeur par défaut : standard.
standarddetailedgeometry_qualitystringOptionnelDéfaut: "standard"Contrôle la qualité géométrique ; detailed ajoute des détails de maillage plus fins. Valeur par défaut : standard.
standarddetailedtexture_alignmentstringOptionnelDéfaut: "original_image"Contrôle le mode d'alignement des textures sur l'image d'entrée. 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/image-to-3d",
"input": {
"pbr": true,
"texture": true,
"image_url": "…",
"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/image-to-3d",
input: {
"pbr": true,
"texture": true,
"image_url": "…",
"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/image-to-3d",
"input": {
"pbr": True,
"texture": True,
"image_url": "…",
"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 →-
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
-
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