Image en 3DÀ propos de Tripo H3.1
Formes 3D précises et couleurs fidèles à partir d’une photo produit.
Appelez-le avec le nom de modèle tripo/h3.1/image-to-3d sur POST /jobs/createTask, à partir de 0,432 $US.
Introduction
Tripo H3.1 est le modèle image vers 3D que Tripo AI a présenté en mars 2026 pour des assets de qualité production, avec une géométrie plus nette, un meilleur alignement sur l'image source et des textures de meilleure qualité que ses modèles de la série H précédents. Vous envoyez une image (image_url) et recevez un fichier glTF binaire (.glb). Contrairement aux convertisseurs à interrupteur unique, chaque étape du pipeline est exposée : texturer ou non le maillage, ajouter des cartes PBR, des textures HD, une géométrie détaillée, une topologie en quads, un nombre de faces cible, une mise à l'échelle réelle, l'orientation finale et deux seeds distincts. Il n'y a pas de prompt.
Points forts
Une forme qui suit l'image
Dans notre test de botte, le modèle a respecté les proportions de la photo et placé la boucle du talon, les crochets de lacet et la semelle du bon côté, alors que la photo ne montrait que l'avant. Le résultat texturé a reporté le cuir usé, les lacets rouges et les coutures sur le maillage.
Des textures à activer et à améliorer
Les textures sont activées par défaut et livrées sous forme de jeu PBR complet. Notre fichier de réglages par défaut contenait, dans un seul matériau, une carte de couleur de base de 2048 pixels, une carte metal-roughness et une carte de normales.
Topologie et taille sous contrôle
face_limit limite le nombre de faces entre 1 000 et 2 000 000, quad_mesh passe à des polygones à quatre côtés pour l'édition dans un outil de modélisation, et geometry_quality: detailed consacre davantage de calcul aux détails fins de surface. auto_size met le maillage à des dimensions réelles et model_orientation: align_image l'oriente selon l'image.
Ce que nous avons mesuré
Avec les réglages par défaut, une vue de face d'une botte en cuir (1024×1024) est revenue en 167 secondes sous forme de GLB de 45,8 Mo avec 1 471 382 triangles et trois textures. Cette densité est la raison pour laquelle il faut définir face_limit pour tout ce qui est affiché dans un navigateur.
Paramètres de requête
| Paramètre | Requis | Description |
|---|---|---|
auto_size | Non | Mettre le maillage à l'échelle des dimensions réelles estimées. Désactivé par défaut. Par défaut: false |
face_limit | Non | Nombre de faces visé, de 1 000 à 2 000 000. Laissez vide pour que le modèle décide (souvent plus d'un million de faces). ≥ 1000 · ≤ 2000000 |
generate_pbr | Non | Ajoute des cartes de matériaux PBR (métal-rugosité et normales). Activé par défaut, ce qui active aussi la texture. Par défaut: true |
generate_texture | Non | Applique une texture sur le maillage. Activé par défaut ; le désactiver ne retire la texture que si generate_pbr est aussi désactivé. Par défaut: true |
geometry_quality | Non | Détail de la géométrie : standard (par défaut) ou detailed. detailed produit des détails de surface plus fins et coûte plus cher. standard · detailed · Par défaut: standard |
image_url | Oui | L’image de départ. |
model_orientation | Non | default conserve l'orientation standard ; align_image fait pivoter le modèle pour correspondre à l'image. default · align_image · Par défaut: default |
quad_mesh | Non | Renvoie des polygones à quatre côtés (quads) au lieu de triangles, pour les retoucher dans les logiciels de modélisation ; le fichier revient alors en FBX au lieu de GLB. Désactivé par défaut ; augmente le prix. Par défaut: false |
seed | Non | Gardez la même valeur de seed et les mêmes réglages pour des comparaisons mieux contrôlées. ≥ 0 · ≤ 2147483647 |
texture_alignment | Non | Aligner la texture sur l'image d'origine (par défaut) ou sur la géométrie générée. original_image · geometry · Par défaut: original_image |
texture_quality | Non | Résolution de la texture : standard (par défaut) ou detailed. detailed coûte plus cher et ne s'applique qu'aux maillages texturés. standard · detailed · Par défaut: standard |
texture_seed | Non | Graine de l'étape de texture. Gardez seed fixe et changez cette valeur pour essayer de nouvelles textures sur la même forme. ≥ 0 · ≤ 2147483647 |
Tarifs
Les prix sont en USD. L’API utilise un solde distinct en dollars américains. Les crédits du site ne peuvent pas être utilisés pour l’API ni convertis en solde API, et le solde API ne peut pas être converti en crédits du site. À l’acceptation d’une tâche, le montant maximal du devis est réservé sur votre solde API. À la fin, la facturation suit l’usage réel, sans dépasser ce montant, et le reste est libéré. En cas d’échec, le montant réservé est libéré.
| Option | USD par génération |
|---|---|
| Standard | 0,432 $US |
Avant l’exécution, envoyez le même corps de requête à POST /jobs/quote pour connaître les frais estimés et leur plafond en USD. Le devis ne lance aucune tâche et ne débite pas votre solde.
Cas d'usage
Assets pour jeux, AR et scènes temps réel
Réglez face_limit sur le budget de votre scène, activez quad_mesh si l'asset doit être modifié, et gardez le PBR activé pour que le modèle réagisse à l'éclairage de la scène.
Visualisation produit et impression
Pour un visualiseur produit, gardez les textures activées et utilisez texture_quality: detailed lorsque les étiquettes ou les coutures doivent rester lisibles. Pour l'impression 3D ou la sculpture, désactivez les deux interrupteurs de texture et réglez auto_size pour obtenir une échelle réaliste.
Guide de prompt et conseils d'expert
Partir d'une image propre
Un seul sujet, entièrement dans le cadre, sur fond uni. Une vue trois-quarts renseigne mieux le modèle sur la profondeur qu'une vue de face bien droite. JPEG, PNG ou WebP jusqu'à 10 Mo.
N'activer que ce qui est nécessaire
Faites une première passe avec les réglages par défaut et un face_limit, puis n'améliorez que l'étape qui reste insuffisante.
Itérer avec les deux seeds
seed fixe la géométrie et texture_seed fixe la texture. Gardez seed et changez texture_seed pour tester de nouvelles surfaces sur la même forme, ou gardez texture_seed pendant que vous explorez les formes.
Vérifier le côté caché
Ouvrez le GLB dans un visualiseur et faites-le pivoter entièrement avant de l'utiliser. Si le côté non visible est incorrect, un autre angle de caméra dans l'image source aide davantage que n'importe quel réglage.
Démarrage rapide de l'API
Appeler l’API Tripo H3.1 en trois étapes
- Créer une clé API. Connectez-vous à PopNow et créez une clé dans la console API. Les clés commencent par sk-popnow-. Les appels API utilisent votre solde distinct en dollars américains.
- Envoyer la requête. Envoyez POST /jobs/createTask avec model tripo/h3.1/image-to-3d et un objet input conforme au tableau des paramètres. La réponse renvoie aussitôt un ID de tâche.
- Récupérer le résultat. Interrogez GET /jobs/recordInfo avec l’ID de tâche, ou passez une callBackUrl et nous y envoyons le résultat. Téléchargez les liens de sortie quand la tâche réussit.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "tripo/h3.1/image-to-3d",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"generate_texture": true,
"generate_pbr": true,
"texture_quality": "standard",
"geometry_quality": "standard",
"model_orientation": "default"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Remplacez le prompt et les liens par les vôtres. L'onglet API contient la référence pour la réponse, le polling et le callback.
Questions sur l’API Tripo H3.1
Combien coûte l’API Tripo H3.1 ?
Tripo H3.1 coûte 0,432 $US par génération. L’API utilise un solde distinct en dollars américains. Les crédits du site ne peuvent pas être utilisés pour l’API ni convertis en solde API, et le solde API ne peut pas être converti en crédits du site. À l’acceptation d’une tâche, le montant maximal du devis est réservé sur votre solde API. À la fin, la facturation suit l’usage réel, sans dépasser ce montant, et le reste est libéré. En cas d’échec, le montant réservé est libéré.
Quel est le nom de modèle de Tripo H3.1 dans l’API ?
Indiquez tripo/h3.1/image-to-3d pour Image en 3D dans le champ model de POST /jobs/createTask.
Que contient le GLB ?
Un maillage avec un matériau intégré. Aux réglages par défaut, notre fichier contenait trois textures en 2048 pixels : couleur de base, métal-rugosité et normal map. Désactivez generate_texture et generate_pbr pour obtenir le maillage nu.
Comment garder un fichier léger ?
Fixez face_limit, par exemple entre 50 000 et 200 000 pour une visionneuse web. Laissé vide, le modèle décide, ce qui dans notre essai a donné plus d’un million de triangles.
Peut-on reproduire un résultat ?
Oui. seed fige l’étape de géométrie et texture_seed celle de la texture : vous pouvez garder la forme et essayer une autre texture, ou l’inverse.
Quelles sont les limites de l’API Tripo H3.1 ?
Taille maximale d’envoi: 10 MB. Les requêtes hors de ces limites sont refusées avant tout débit.
Puis-je essayer Tripo H3.1 sans écrire de code ?
Exécutez Tripo H3.1 dans le Playground avec votre solde API en USD, sans clé API. Chaque exécution figure dans votre historique développeur avec le code correspondant.
