API Texte en 3D

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

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

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

Valeurs disponibles :

• standard : Génération de maillage 3D régulière haute résolution.
• 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 nets. 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-5, meshy-6, meshy-7, latest (Meshy 7)

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.

Active la génération Ultra pour une géométrie de plus haute fidélité avec des détails de surface plus fins. La génération prend plus de temps et coûte 5 crédits supplémentaires.

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 différer 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, valeur 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 nécessaire. Plage de 100 à 15 000, valeur par défaut 4 000.

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

Le champ symmetry_mode contrôle le comportement de la 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 dans une pose A.
• t-pose : Génère le modèle dans une 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 dans une 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.

Lorsqu'il est défini sur true, le contenu saisi sera automatiquement analysé pour détecter tout contenu potentiellement dangereux. Si un contenu dangereux 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. Si omis, tous les formats pris en charge sont inclus.

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

Lorsqu'il est défini sur true, la tâche restitue en plus une version à fond transparent (RGBA) de la prévisualisation et la renvoie sous forme de alpha_thumbnail_url dans la réponse GET. Le champ thumbnail_url existant reste inchangé.

Lorsqu'il 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 définie sur 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.

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 de raffinage.

L'identifiant de la tâche d'aperçu correspondante.

Le statut de la tâche d'aperçu 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-7 (et latest) ne produit 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 — équivalent à texture_resolution: "4k". Lorsque les deux sont définis, texture_resolution a la priorité.

Fournit un prompt textuel supplémentaire pour guider le processus de texturage. 800 caractères maximum.

Fournit 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 : un URI de données encodé 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 raffinage. Valeurs disponibles : meshy-5, meshy-6, meshy-7, latest (Meshy 7).

Lorsqu'il est défini sur true, le contenu saisi 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 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 d'exécution de la tâche. Lorsqu'il est omis, tous les formats pris en charge sont inclus.

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

Lorsqu'il est défini sur true, la tâche génère en plus une version à fond transparent (RGBA) de l'aperçu et la renvoie sous la forme alpha_thumbnail_url dans la réponse GET. Le champ existant thumbnail_url reste inchangé.

Lorsqu'il 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 courantes :

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

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

Crédits insuffisants pour effectuer cette tâche.

La tâche d'aperçu spécifiée par preview_task_id n'a pas été trouvée.

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 date de création par ordre croissant.
• -created_at : Trier par date de création par ordre décroissant.

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

Identifiant unique de la tâche. Bien que nous utilisions un UUID k-sortable 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 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é, plutôt que 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 pris 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.

Reprend la valeur ultra_mode avec laquelle la tâche preview a été créée. Présent uniquement pour les tâches preview meshy-7 (ou latest) qui définissent explicitement ultra_mode ; omis sinon.

URL téléchargeable vers l'image de texture qui a été 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 PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Un tableau d'objets URL de texture générés par la tâche. Normalement, il 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 échouées. 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).