API Texte en 3D

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

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

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

Valeurs disponibles :

• standard: Génération de maillage 3D standard à haut niveau de détail.
• lowpoly: Génère un maillage low-poly optimisé pour des polygones plus propres.

ID du modèle à utiliser. Valeurs disponibles : meshy-5, meshy-6, latest (Meshy 6).

Contrôle l’activation ou non de la phase de Remaillage. Lorsque défini sur false, l’API renverra directement le maillage triangulaire de la plus haute précision.

Obsolète (deprecated). 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: Impose la symétrie pendant la génération.

Spécifiez le mode de pose 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 pris 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 du 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 renvoyés, ce qui peut réduire le temps d’exécution de la tâche. En cas d’omission, 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 de l’aperçu avec arrière-plan transparent (RGBA) et la 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 :

• Paramètre manquant: Un paramètre requis (par ex., 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.

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 d’affinage.

L’ID de la tâche de prévisualisation correspondante.

Le statut de la tâche de prévisualisation fournie 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 ou latest.

Génère la texture de couleur de base en résolution 4K (4096×4096) pour un niveau de détail plus élevé.

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

Fournissez une image 2D pour guider le processus de texturage. 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 Data URI encodée en base64 de l’image. Exemple de Data URI : data:image/jpeg;base64,<your base64-encoded image data>

ID du modèle à utiliser pour l’affinage. Valeurs disponibles : meshy-5, meshy-6, latest (Meshy 6).

Lorsque ce paramètre est défini sur true, le contenu d’entrée sera automatiquement analysé afin de détecter du contenu potentiellement nuisible. Si du contenu nuisible est détecté, la tâche ne passera pas à la génération.

Le texte de texture_prompt et l’image de texture_image_url seront tous deux 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 de réalisation de la tâche. En cas d’omission, tous les formats pris en charge sont inclus.

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

Lorsque ce paramètre est défini sur true, la tâche rend en plus une version de la prévisualisation avec arrière-plan transparent (RGBA) et la renvoie sous la forme alpha_thumbnail_url dans la réponse GET. Le champ existant thumbnail_url reste inchangé.

Lorsque ce paramètre est 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 fréquentes :

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

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

Crédits insuffisants pour effectuer cette tâche.

La tâche de prévisualisation 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 50 éléments.

Champ selon lequel trier.

Valeurs disponibles :

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

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

Identifiant unique de la tâche. Bien que nous utilisions un UUID triable en k pour les identifiants de tâche 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 de prévisualisation et text-to-3d-refine pour les tâches de l’étape d’affinage.

URL téléchargeable du 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.

Maintenu pour compatibilité descendante. 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 de prévisualisation. Non pris en charge par Meshy-6.

Maintenu pour compatibilité descendante. Ce champ n’a aucun impact fonctionnel sur les modèles générés.

Prompt textuel supplémentaire fourni pour guider le processus d’application de texture pendant l’étape d’affinage.

URL téléchargeable de l’image de texture qui a été utilisée pour guider le processus d’application de texture.

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

URL téléchargeable d’une version à arrière-plan transparent (RGBA) de thumbnail_url. Présent uniquement lorsque la tâche a été créée avec alpha_thumbnail: true et que la prévisualisation transparente a été rendue avec succès ; sinon, ce champ est omis.

URL téléchargeable de la vidéo de prévisualisation. Sera supprimée dans une prochaine version.

progress 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 de PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Un tableau d’objets d’URL de texture générés à partir de la tâche. Normalement, il ne contient qu’un objet d’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).