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 le statut SUCCEEDED.

Veuillez fournir un modèle 3D que Meshy pourra remailler 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.

Taille de fichier maximale : 100 Mo.

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

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

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

Valeurs disponibles :

• quad : génère un maillage à dominante de quadrilatères.
• triangle : génère un maillage de triangles décimé.

Spécifie le nombre cible de polygones dans le modèle généré. Le nombre réel de polygones peut s'écarter de la cible en fonction de la complexité de la géométrie.

La plage de valeurs valide varie selon le niveau utilisateur :

• 100 à 300 000 (inclus)

Active 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 l'API dédiée Resize API à la place.

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 l'API dédiée Resize API à la place.

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. Nous recommandons d'utiliser l'API dédiée Resize API à la place.

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

Lorsqu'il est défini sur true, la tâche génère en plus une version avec arrière-plan transparent (RGBA) de l'aperçu et la renvoie en tant que 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 : soit model_url, soit input_task_id doit être fourni.
• Tâche d'entrée invalide : input_task_id doit faire référence à 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é.
• Fichier modèle trop volumineux : le fichier model_url dépasse 100 Mo.
• Topology invalide : le paramètre topology est invalide.
• Paramètres mutuellement exclusifs : auto_size et resize_height ne peuvent pas être définis tous les deux.

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 k (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'identifiant.

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

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.

URL téléchargeable vers une image d'aperçu générée à 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 commencé, cette propriété sera 0. Une fois la tâche réussie, elle deviendra 100.

Statut de la tâche. Les valeurs possibles sont 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. Voir 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. Retourne 0 pour les tâches FAILED (les crédits sont remboursés en cas d'échec).