Image vers modèle 3D — Série P

POST /v3/generation/image-to-model

Générez un modèle 3D à partir d’une image à l’aide des modèles de la série P. Optimisé pour la génération low-poly avec une topologie propre.

Principales différences par rapport à la norme

Optimisé pour la sortie low-poly (P1-20260311 : 50 à 20 000 faces ; P2-20260801 : jusqu’à 50 000)
quad n’est pris en charge que par P2-20260801 ; smart_low_poly, generate_parts et geometry_quality ne sont pas pris en charge

Paramètres de la demande

Paramètre	Tapez	Obligatoire	Par défaut	Descriptif
input	chaîne	Obligatoire	-	Source des images. Accepte file_token, URL ou task_id
model	chaîne	Obligatoire	-	Version du modèle série P. À définir pour appeler la série P ; s’il est omis, la requête s’exécute sur le modèle par défaut de la série H, `v3.1-20260211`. Valeurs : `P1-20260311` (optimisé low-poly), `P2-20260801` (nouvelle génération, prend en charge la sortie quad ; préversion)
enable_image_autofix	booléen	Facultatif	faux	Utilisé pour la complétion par IA et l’amélioration du rendu 3D. Améliorer automatiquement les images d’entrée de faible qualité
texture_alignment	chaîne	Facultatif	original_image	`original_image` ou `geometry`
orientation	chaîne	Facultatif	par défaut	`default` ou `align_image`
model_seed	entier	Facultatif	aléatoire	Graine aléatoire pour la géométrie
face_limit	entier	Facultatif	adaptatif	Nombre maximum de polygones. `P1-20260311` : 50 à 20 000 ; `P2-20260801` triangles : 48 à 50 000, avec `quad=true` : 48 à 25 000
texture	booléen	Facultatif	vrai	Activer les cartes de texture
pbr	booléen	Facultatif	vrai	Activez PBR. Texture des forces = vrai
texture_seed	entier	Facultatif	aléatoire	Graine aléatoire pour la texture
texture_quality	chaîne	Facultatif	norme	`fast` (nécessite `texture_version=v3.5-20260815`), `standard`, `detailed` ou `extreme`
texture_version	chaîne	Facultatif	Dérivé de model	Fixe le modèle de texture : `v3.5-20260815`, `v3.0-20250812` ou `v2.5-20250123`. Par défaut `v3.0-20250812` pour la géométrie de la série P
delight	booléen	Facultatif	true	Supprime l’éclairage incrusté de l’image de référence avant le texturage. Pris en compte uniquement lorsque `texture_version=v3.5-20260815`
auto_size	booléen	Facultatif	faux	Adaptez-vous aux dimensions du monde réel
export_uv	booléen	Facultatif	vrai	Contrôle de déballage UV
export_orientation	chaîne	Facultatif	`+x`	Orientation export. Valeurs disponibles : `-x`, `-y`, `+y`
quad	booléen	Facultatif	false	`P2-20260801` uniquement. Génère un maillage quad au lieu de triangles. Force le format de sortie à `FBX` ; sans `face_limit`, la valeur par défaut est 10 000 faces.

Remarques sur export_orientation :

S’applique uniquement à cette génération. Si le modèle doit être utilisé dans des tâches de post-traitement (texture, rig, reciblage, conversion, …), il est recommandé de ne pas définir ce paramètre.
Lorsqu’il est défini, le post-traitement peut affecter le résultat final en raison d’une orientation incorrecte du modèle, tout en rapportant status: success — aucune erreur n’est levée. À utiliser avec prudence.
Si vous prévoyez de post-traiter le modèle, laissez ce paramètre vide et convertissez l’orientation à la dernière étape via /v3/models/convert.

Exemple

JSON

{
  "input": "https://example.com/image.png",
  "model": "P1-20260311",
  "face_limit": 5000,
  "texture": true,
  "pbr": true
}

P2-20260801 avec sortie quad :

JSON

{
  "input": "https://example.com/image.png",
  "model": "P2-20260801",
  "quad": true,
  "face_limit": 8000,
  "texture": true,
  "pbr": true
}