Tripo
Tripo H3.1
tripo-h3.1/text-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/text-to-3d
Entrée
Sortie
Tarifs
tripo-h3.1/text-to-3d per model
+ $0.290 géométrie plus fine · si détaillée est sélectionné
Présentation
Il s'agit d'un service de génération de modèles 3D à partir de texte : il suffit au développeur de saisir une description en langage naturel pour obtenir un actif de modèle 3D texturé. Le prompt compte au maximum 1024 caractères ; les éléments indésirables peuvent être exclus via un prompt négatif, et il est possible de définir séparément la qualité de la géométrie et celle de la texture, d'activer ou non la sortie de matériaux PBR, de fixer une limite supérieure du nombre de triangles ainsi que plusieurs graines aléatoires pour reproduire les résultats. Les résultats générés conviennent aux prototypes de jeux, à la visualisation de produits, au design conceptuel et à tout autre scénario où il faut transformer rapidement une idée textuelle en modèle 3D ; le service s'adresse aux développeurs de contenu 3D, aux créateurs indépendants et aux équipes de design.
Points clés
- Génération directe d'actifs 3D à partir de texte — une simple phrase de description suffit pour produire un modèle 3D doté de géométrie et de texture, ce qui évite la première étape de la modélisation manuelle.
- Qualité de géométrie et de texture réglable séparément — la qualité géométrique et la qualité de texture disposent chacune de deux niveaux, standard et fin, permettant d'équilibrer détail et volume de production selon l'usage.
- Matériaux PBR et interrupteur de texture — les matériaux et textures PBR sont générés par défaut ; il est aussi possible de désactiver simultanément texture et PBR pour ne conserver qu'un maillage purement géométrique, adapté à différents pipelines en aval.
- Paramètres de graine pour reproduire les résultats — l'image conceptuelle, la géométrie et la texture disposent chacune d'une graine aléatoire, ce qui facilite la répétition ou l'ajustement fin des résultats avec les mêmes réglages.
Description des capacités
Génération de modèles 3D à partir d'une description textuelle : construit la géométrie 3D à partir du prompt, qui compte au maximum 1024 caractères ; un prompt négatif peut compléter celui-ci pour exclure les éléments non souhaités, ce qui convient à la création d'actifs conceptuels à partir de zéro.
Contrôle de la cible de triangles : le paramètre de limite supérieure de faces permet de spécifier le nombre cible de triangles, dans une plage de 1 000 à 1,5 million (2 millions pour une géométrie fine) ; sans réglage, le modèle décide de manière adaptative, ce qui facilite l'adéquation aux besoins de rendu en aval.
Sortie de matériaux et de textures PBR : les matériaux et textures PBR sont générés par défaut ; lorsque texture et PBR sont désactivés simultanément, la sortie est un maillage purement géométrique ; la qualité de texture peut être standard ou fine, le niveau fin produisant des textures de résolution plus élevée.
Finesse géométrique réglable : la qualité géométrique peut être choisie entre standard et fine ; le niveau fin ajoute des détails de maillage plus denses, adapté aux actifs destinés à une présentation en gros plan ou à un affinage ultérieur.
Cas d'usage
- Production rapide de modèles d'objets pour des prototypes de jeux — un game designer ou un développeur indépendant décrit l'apparence d'un objet en texte, génère un modèle 3D texturé et l'importe dans le moteur pour valider le prototype et construire les niveaux.
- Création d'actifs conceptuels pour la visualisation de produits — une équipe de design génère des modèles 3D à partir de descriptions de produits, pour la présentation de premières pistes, des ébauches visuelles marketing et des revues internes.
- Itération de design conceptuel 3D — un concepteur génère en lot des variantes avec différents prompts et graines, compare rapidement les directions de forme et sélectionne les actifs à faire passer en phase d'affinage.
Limites et conseils de choix
La longueur du prompt est limitée de 1 à 1024 caractères ; au-delà, la soumission est impossible. La limite supérieure de faces n'accepte que des entiers entre 1 000 et 1,5 million (2 millions pour une géométrie fine) ; sans réglage, le modèle détermine lui-même le nombre de triangles. La qualité de texture et la qualité géométrique sont chacune des options à deux choix, et une seule peut être sélectionnée par requête. Lorsque texture et PBR sont tous deux désactivés, le résultat est un maillage purement géométrique, sans textures de surface. Les paramètres de graine améliorent la reproductibilité, mais une même graine ne garantit pas des résultats strictement identiques.
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/text-to-3d
routestringOptionnelValeur fixe actuelle : default
inputobjectRequis
Objet de paramètres métier pour tripo-h3.1/text-to-3d et la route default — voir le tableau des paramètres ci-dessous.
pbrbooleanOptionnelDéfaut: trueIndique s'il faut générer des matériaux PBR ; prend une valeur booléenne, par défaut true ; lorsque true, des textures sont également générées.
promptstringRequisminLength 1maxLength 1024Texte décrivant l'objet à générer, par exemple une petite théière en céramique, utilisé comme prompt d'entrée pour la génération 3D à partir de texte.
texturebooleanOptionnelDéfaut: trueIndique s'il faut générer des textures pour le modèle, par défaut true. À noter : lorsque 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 faces triangulaires, entier, plage 1000–1500000 (jusqu'à 2000000 lorsque geometry_quality=detailed) ; s'il est 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_seedintegerOptionnelGraine aléatoire pour la génération de l'image conceptuelle, entier, utilisée pour reproduire le même résultat d'image conceptuelle.
model_seedintegerOptionnelGraine aléatoire reproductible pour la génération de la géométrie, entier, utilisée pour reproduire de manière stable le même résultat géométrique.
texture_seedintegerOptionnelGraine aléatoire reproductible pour la génération des textures, entier, utilisée pour reproduire de manière stable le même résultat de texture.
negative_promptstringOptionnelmaxLength 1024Prompt négatif décrivant ce qu'il faut éviter lors de la génération.
texture_qualitystringOptionnelDéfaut: "standard"Niveau de qualité des textures, chaîne de caractères, par défaut standard ; le niveau detailed génère des textures de résolution supérieure.
standarddetailedgeometry_qualitystringOptionnelDéfaut: "standard"Niveau de qualité géométrique, chaîne de caractères, par défaut standard ; le niveau detailed offre des détails de maillage plus fins.
standarddetailedcallbackobjectOptionnel
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/text-to-3d",
"input": {
"pbr": true,
"prompt": "…",
"texture": true,
"texture_quality": "standard",
"geometry_quality": "standard"
}
}' 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/text-to-3d",
input: {
"pbr": true,
"prompt": "…",
"texture": true,
"texture_quality": "standard",
"geometry_quality": "standard"
}
}),
});
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/text-to-3d",
"input": {
"pbr": True,
"prompt": "…",
"texture": True,
"texture_quality": "standard",
"geometry_quality": "standard"
}
},
)
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 →-
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
-
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
-
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