API de Remaillage

L'ID de la tâche Image en 3D ou Texte en 3D terminée que vous souhaitez remailler. Cette tâche doit être l'une des suivantes : Texte en 3D Preview, Texte en 3D Refine, Image en 3D ou Retexturisation. De plus, elle doit avoir un statut SUCCEEDED.

Veuillez fournir un modèle 3D à Meshy pour le remaillage via une URL accessible publiquement ou un Data URI. Formats pris en charge : .glb, .gltf, .obj, .fbx, .stl.

Pour les Data URI, utilisez le MIME type : application/octet-stream.

Une liste de formats cibles pour le modèle remaillé. Si omis, seul un GLB est généré.

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

Spécifiez la topology du modèle généré.

Valeurs disponibles :

• quad : Génère un maillage à dominante quadrangulaire.
• triangle : Génère un maillage triangulaire décimé.

Spécifiez le nombre cible de polygones dans le modèle généré. Le nombre réel de polygones peut différer de la cible selon la complexité de la géométrie.

La plage de valeurs valides varie selon le niveau utilisateur :

• 100 à 300 000 (inclus)

Activez la décimation adaptative en définissant un niveau de nombre de polygones. Lorsqu'il est défini, target_polycount est ignoré.

Valeurs disponibles :

• 1 : Adaptatif — nombre de polygones ultra.
• 2 : Adaptatif — nombre de polygones élevé.
• 3 : Adaptatif — nombre de polygones moyen.
• 4 : Adaptatif — nombre de polygones faible.

Redimensionne le modèle à une certaine hauteur mesurée en mètres. Nous recommandons d'utiliser plutôt l'API dédiée Resize API.

Redimensionne le modèle de sorte que la plus grande dimension de la boîte englobante soit égale à la valeur spécifiée en mètres. Nous recommandons d'utiliser plutôt l'API dédiée Resize API.

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. Nous recommandons d'utiliser plutôt l'API dédiée Resize API.

Si true, le service ne fera que changer le format du fichier de modèle d'entrée, en ignorant les autres entrées comme topology, resize_height et target_polycount. Nous recommandons d'utiliser plutôt l'API dédiée Convert API.

Lorsque défini sur true, la tâche effectue en plus le rendu d'une version à fond transparent (RGBA) de l'aperçu et la renvoie sous forme de alpha_thumbnail_url dans la réponse GET. Le champ existant thumbnail_url reste inchangé.

La requête était inacceptable. Causes courantes :

• Paramètre manquant : model_url ou input_task_id doit être fourni.
• Tâche d'entrée invalide : input_task_id doit référencer une tâche réussie provenant d'un modèle pris en charge.
• Format de modèle invalide : model_url pointe vers un fichier avec une extension non prise en charge.
• URL inaccessible : model_url n'a pas pu être téléchargée.
• Topology invalide : le paramètre topology est invalide.
• Paramètres mutuellement exclusifs : auto_size et resize_height ne peuvent pas être définis en même temps.

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.

L'ID de la tâche de remaillage à récupérer.

L'ID de la tâche de remaillage à 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 de Remaillage à diffuser.

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

Type de la tâche de remaillage. La valeur est remesh.

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

URL téléchargeable vers une image d'aperçu rendue à partir du modèle remaillé.

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é généré avec succès ; sinon, ce champ est omis.

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.

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

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

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

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 fin de la tâche, en millisecondes. Si la tâche n'est pas encore terminée, cette propriété sera 0.

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).