Texte en modèle 3D — Série P

POST /v3/generation/text-to-model

Générez un modèle 3D à partir d’une invite de texte à l’aide des modèles de la série P. La série P est optimisée pour une génération low-poly de premier ordre avec une topologie propre et raffinée, idéale pour les ressources de jeu, le contenu stylisé et les flux de travail 3D légers.

Principales différences par rapport à la norme

Optimisé pour la sortie low-poly (P1-20260311 : 50 à 20 000 faces ; P2-20260801 : jusqu’à 50 000)
Génération de maillage ~2s avec topologie structurée
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
prompt	chaîne	Obligatoire	-	Invite de texte, jusqu’à 1 024 caractères
negative_prompt	chaîne	Facultatif	-	Invite négative, jusqu’à 255 caractères
image_seed	entier	Facultatif	aléatoire	Graine aléatoire pour l’étape de conversion texte-image
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)
model_seed	entier	Facultatif	aléatoire	Graine aléatoire pour la génération de 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 les cartes de matériaux PBR. Texture des forces = vrai
texture_seed	entier	Facultatif	aléatoire	Graine aléatoire pour la génération de 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	Échelle aux dimensions du monde réel (mètres)
export_uv	booléen	Facultatif	vrai	Déballage UV. false = fichier plus rapide et plus petit
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

{
  "prompt": "a low poly medieval sword",
  "model": "P1-20260311",
  "face_limit": 3000,
  "texture": true,
  "texture_quality": "detailed"
}

P2-20260801 avec sortie quad :

JSON

{
  "prompt": "a low poly medieval sword",
  "model": "P2-20260801",
  "quad": true,
  "face_limit": 8000,
  "texture": true
}

Réponse

JSON

{
  "code": 0,
  "data": {
    "task_id": "task_abc123"
  }
}