API Texte en 3D

Ce champ doit être défini sur "preview" lors de la création d'une tâche de preview.

Décrivez le type d'objet que représente le modèle 3D. Maximum 800 caractères.

Spécifie le type de génération de maillage 3D.

Valeurs disponibles :

• standard : génération de maillage 3D standard haute-définition.
• smart-topology : choisissez le modèle Smart Topology avec ai_model (meshy-t2).
• lowpoly (obsolète) : génère un maillage low-poly optimisé pour des polygones plus propres. Nous recommandons d'utiliser smart-topology à la place.

ID du modèle à utiliser. Les valeurs disponibles dépendent de model_type.

Génération standard (model_type: standard) :

• meshy-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
• meshy-7 (obsolète) : utilisez meshy-7.1 à la place.

Génération Smart Topology (model_type: smart-topology) :

• meshy-t2 (par défaut) : le modèle Smart Topology — topology plus propre, parties nativement séparées, sortie en triangles, et un nombre de faces que vous pouvez définir avec target_polycount.

Passe de génération de géométrie. 2k exécute la passe Ultra à 2048³ ; 4k l'exécute à 4096³ pour le détail de surface le plus fin.

Valeurs disponibles : standard, 2k, 4k

Utilisez geometry_resolution à la place. ultra_mode: true équivaut à geometry_resolution: "2k".

Contrôle l'activation de la phase de remaillage. Pour le modèle de la plus haute qualité, nous recommandons de définir should_remesh sur false.

Nombre cible de polygones (faces) dans la sortie. Le nombre réel peut s'écarter de la cible selon la géométrie.

target_polycount s'applique dans deux cas indépendants :

• Remaillage — avec should_remesh: true sur un modèle standard. Le maillage est remaillé (décimé) pour atteindre approximativement ce nombre. Plage de 100 à 300 000, par défaut 30 000. Si decimation_mode est défini, il est prioritaire et target_polycount est ignoré.
• Smart Topology — avec model_type: smart-topology et ai_model: meshy-t2. Le modèle est généré directement avec ce nombre de faces ; aucun remaillage n'est exécuté et should_remesh n'est pas requis. Plage de 100 à 15 000, par défaut 4 000.

Obsolète. Ce paramètre n'affecte plus la sortie.

Le champ symmetry_mode contrôle le comportement de symétrie pendant le processus de génération du modèle.

Les valeurs valides sont :

• off : désactive la symétrie.
• auto : détermine et applique automatiquement la symétrie en fonction de la géométrie d'entrée.
• on : force la symétrie pendant la génération.

Spécifie le pose_mode pour le modèle généré.

Valeurs disponibles :

• a-pose : génère le modèle en pose A.
• t-pose : génère le modèle en pose T.
• "" (chaîne vide) : aucune pose spécifique appliquée.

Utilisez pose_mode à la place. Indique s'il faut générer le modèle en pose A/T.

Non prise en charge par Meshy-6. Les requêtes utilisant Meshy-6 ignoreront art_style, et certaines combinaisons peuvent provoquer des erreurs. Valeurs disponibles : realistic, sculpture.

Lorsque défini sur true, le contenu d'entrée sera automatiquement analysé pour détecter tout contenu potentiellement nuisible. Si un contenu nuisible est détecté, la tâche ne passera pas à la génération.

Le texte de prompt sera analysé.

Spécifie les formats de fichiers 3D à inclure dans la sortie. Seuls les formats demandés seront générés et retournés, ce qui peut réduire le temps d'exécution de la tâche. Si omis, tous les formats pris en charge sont inclus.

Valeurs disponibles : glb, obj, fbx, stl, usdz, 3mf

Lorsque défini sur true, la tâche rend en plus une version à fond transparent (RGBA) de la preview et la retourne dans alpha_thumbnail_url sur la réponse GET. Le champ existant thumbnail_url reste inchangé.

Lorsque défini sur true, le service utilise la vision par IA pour estimer automatiquement la hauteur réelle de l'objet et redimensionner le modèle en conséquence. L'origine sera par défaut bottom sauf si origin_at est explicitement défini.

La requête était inacceptable. Causes courantes :

• Paramètre manquant : un paramètre requis (par exemple, prompt, mode) est manquant.
• Paramètre invalide : art_style ne fait pas partie des valeurs autorisées.
• Prompt trop long : le prompt dépasse la limite de caractères.
• Modèle non pris en charge pour low poly : ai_model: "meshy-6-lite" ne prend pas en charge model_type: "lowpoly".
• Modèle non pris en charge pour Ultra : geometry_resolution nécessite meshy-7.1 ou latest.

L'authentification a échoué. Veuillez vérifier votre clé API.

Crédits insuffisants pour effectuer cette tâche.

Vous avez dépassé votre limite de débit.

Ce champ doit être défini sur "refine" lors de la création d'une tâche refine.

L'identifiant de la tâche preview correspondante.

Le statut de la tâche preview donnée doit être SUCCEEDED.

Génère des cartes PBR (métallique, rugosité, normale) en plus de la couleur de base. Une carte d'émission est également incluse lorsque ai_model est meshy-6, sauf à texture_resolution: 8k (aucune carte d'émission n'est produite). meshy-6-lite, meshy-7.1 et latest ne produisent pas de carte d'émission.

Résolution de la texture de couleur de base. L'une des valeurs suivantes : 2k (2048×2048), 4k (4096×4096) ou 8k (8192×8192). Des résolutions plus élevées capturent davantage de détails de surface. S'applique uniquement au mode refine.

Utilisez texture_resolution à la place — équivaut à texture_resolution: "4k". Lorsque les deux sont définis, texture_resolution est prioritaire.

Fournissez un prompt textuel supplémentaire pour guider le processus de texturation. Maximum 800 caractères.

Fournissez une image 2D pour guider le processus de texturation. Nous prenons actuellement en charge les formats .jpg, .jpeg et .png.

Il existe deux façons de fournir l'image :

• URL accessible publiquement : une URL accessible depuis l'internet public
• Data URI : une URI de données encodée en base64 de l'image. Exemple de Data URI : data:image/jpeg;base64,<vos données d'image encodées en base64>

ID du modèle à utiliser pour le refine.

Valeurs disponibles :

• meshy-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
• meshy-7 (obsolète) : utilisez meshy-7.1 à la place.

Omettez ce paramètre pour hériter du modèle utilisé par la tâche preview, ce qui permet de conserver le même modèle de bout en bout entre un preview et son refine. Passez une valeur explicite pour outrepasser cet héritage.

Lorsque défini sur true, le contenu fourni sera automatiquement analysé afin de détecter tout contenu potentiellement nuisible. Si un contenu nuisible est détecté, la tâche ne passera pas à l'étape de génération.

Le texte de texture_prompt ainsi que l'image de texture_image_url seront analysés.

Supprime les reflets et les ombres de la texture de couleur de base, produisant un résultat plus propre qui fonctionne mieux avec des configurations d'éclairage personnalisées.

Spécifie les formats de fichiers 3D à inclure dans la sortie. Seuls les formats demandés seront générés et renvoyés, ce qui peut réduire le temps d'achèvement de la tâche. Si omis, tous les formats pris en charge sont inclus.

Valeurs disponibles : glb, obj, fbx, stl, usdz, 3mf

Lorsque défini sur true, la tâche effectue en plus un rendu de la preview avec un fond transparent (RGBA) et le renvoie sous la forme alpha_thumbnail_url dans la réponse GET. Le champ existant thumbnail_url reste inchangé.

Lorsque défini sur true, le service utilise la vision par IA pour estimer automatiquement la hauteur réelle de l'objet et redimensionner le modèle en conséquence. L'origine sera par défaut bottom sauf si origin_at est explicitement défini.

La requête était inacceptable. Causes courantes :

• ID de tâche invalide : le preview_task_id est invalide ou n'existe pas.
• Tâche non prête : la tâche preview n'a pas encore réussi.
• Incompatibilité de modèle : le modèle d'IA de la tâche preview est incompatible avec le modèle de refine demandé.

L'authentification a échoué. Veuillez vérifier votre clé API.

Crédits insuffisants pour effectuer cette tâche.

La tâche preview spécifiée par preview_task_id est introuvable.

Vous avez dépassé votre limite de débit.

Identifiant unique de la tâche Texte en 3D à récupérer.

L'ID de la tâche Texte en 3D à supprimer.

Numéro de page pour la pagination.

Limite de taille de page. Le maximum autorisé est de 100 éléments.

Champ selon lequel trier.

Valeurs disponibles :

• +created_at : Trier par heure de création dans l'ordre croissant.
• -created_at : Trier par heure de création dans l'ordre décroissant.

Identifiant unique de la tâche Texte en 3D à diffuser en continu.

Identifiant unique de la tâche. Bien que nous utilisions un UUID triable par k pour les identifiants de tâches comme détail d'implémentation, vous ne devez pas faire d'hypothèses sur le format de l'id.

Type de la tâche Texte en 3D. Les valeurs possibles sont text-to-3d-preview pour les tâches de l'étape preview et text-to-3d-refine pour les tâches de l'étape refine.

URL téléchargeable vers le fichier de modèle 3D texturé généré par Meshy. La propriété d'un format sera omise si le format n'est pas généré, au lieu de renvoyer une chaîne vide.

Il s'agit du prompt non modifié qui a été utilisé pour créer la tâche.

Conservé pour la compatibilité ascendante. Ce champ n'a aucun impact fonctionnel sur les modèles générés.

Le art_style non modifié qui a été utilisé pour créer la tâche preview. Non prise en charge par Meshy-6.

Conservé pour la compatibilité ascendante. Ce champ n'a aucun impact fonctionnel sur les modèles générés.

Prompt textuel supplémentaire fourni pour guider le processus de texturation pendant l'étape refine.

Obsolète ; utilisez plutôt geometry_resolution.

Le niveau Ultra sur lequel la tâche preview a été exécutée (2k ou 4k) ; omis pour standard.

URL téléchargeable vers l'image de texture utilisée pour guider le processus de texturation.

URL téléchargeable vers l'image miniature du fichier de modèle.

URL téléchargeable vers une version à fond transparent (RGBA) de thumbnail_url. Présent uniquement lorsque la tâche a été créée avec alpha_thumbnail: true et que l'aperçu transparent a été rendu avec succès ; sinon, ce champ est omis.

URL téléchargeable vers la vidéo d'aperçu. Sera supprimé dans une future version.

Progression de la tâche. Si la tâche n'a pas encore démarré, cette propriété sera 0. Une fois la tâche réussie, elle deviendra 100.

Horodatage du démarrage de la tâche, en millisecondes. Si la tâche n'a pas encore démarré, cette propriété sera 0.

Horodatage de la création de la tâche, en millisecondes.

Horodatage de la fin de la tâche, en millisecondes. Si la tâche n'est pas encore terminée, cette propriété sera 0.

Statut de la tâche. Les valeurs possibles sont l'une des suivantes : PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Un tableau d'objets URL de texture générés à partir de la tâche. Normalement, celui-ci ne contient qu'un seul objet URL de texture. Chaque URL de texture possède les propriétés suivantes :

Le nombre de tâches précédentes.

Détails de l'erreur pour les tâches ayant échoué. Consultez Erreurs pour la référence complète de l'objet task_error.

Le nombre de crédits consommés par cette tâche. Présent lorsque le statut de la tâche est PENDING, IN_PROGRESS, ou SUCCEEDED. Renvoie 0 pour les tâches FAILED (les crédits sont remboursés en cas d'échec).