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 tâches suivantes : Aperçu Texte en 3D, Affinage Texte en 3D, Image en 3D ou Retexturisation. De plus, elle doit avoir le statut SUCCEEDED.

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

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

Une liste des formats cibles pour le modèle remaillé. En cas d’omission, seul 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érer un maillage à dominante quadrilatérale.
• triangle : Générer 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 s’écarter de la cible selon la complexité de la géométrie.

La plage de valeurs valide 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 élevé.
• 2 : Adaptatif — nombre de polygones élevé.
• 3 : Adaptatif — nombre de polygones moyen.
• 4 : Adaptatif — faible nombre de polygones.

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

Redimensionner le modèle afin que la plus longue dimension de la boîte englobante soit égale à la valeur spécifiée en mètres. Nous recommandons d’utiliser plutôt l’API Redimensionner dédiée.

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 plutôt l’API Redimensionner dédiée.

Si true, le service changera uniquement 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 Convertir dédiée.

Lorsqu’il est défini sur true, la tâche rend en plus une version avec arrière-plan transparent (RGBA) de l’aperçu et la renvoie sous forme de alpha_thumbnail_url dans la réponse GET. Le champ thumbnail_url existant 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 faire référence à une tâche réussie issue 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 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 50 éléments.

Champ selon lequel trier.

Valeurs disponibles :

• +created_at: Trier par date de création dans l’ordre croissant.
• -created_at: Trier par date 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 clé 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 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é correspondant à un format sera omise si le format n’est pas généré, au lieu 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 à 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 l’aperçu transparent a été rendu 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).