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, Affiner Texte en 3D, Image en 3D ou Retexturisation. De plus, elle doit avoir un statut de SUCCEEDED.

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

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

Une liste de formats cibles pour le modèle remaillé. Lorsqu'il est omis, 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 dominant en quadrilatères.
• 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 dévier de la cible en fonction de la complexité de la géométrie.

La plage de valeurs valides varie en fonction du 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 — ultra nombre de polygones.
• 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 l'Resize API dédiée à la place.

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

Lorsqu'il est défini sur true, le service utilise la vision AI pour estimer automatiquement la hauteur réelle de l'objet et redimensionner le modèle en conséquence. Nous recommandons d'utiliser l'Resize API dédiée à la place.

Si true, le service ne changera que 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'Convert API dédiée à la place.

Lorsqu'il est défini sur true, la tâche rend également une version avec fond 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 : Soit model_url soit input_task_id doit être fourni.
• Tâche d'entrée invalide : Le input_task_id doit se référer à une tâche réussie d'un modèle pris en charge.
• Format de modèle invalide : Le model_url pointe vers un fichier avec une extension non prise en charge.
• URL inaccessible : Le model_url n'a pas pu être téléchargé.
• Topology invalide : Le paramètre topology est invalide.
• Paramètres mutuellement exclusifs : auto_size et resize_height ne peuvent pas être définis simultanément.

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 pour trier par.

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 pour la tâche de Remaillage à diffuser.

Identifiant unique pour la tâche. Bien que nous utilisions un UUID triable par k pour les identifiants de tâche en tant que 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é pour un format sera omise si le format n'est pas généré au lieu de retourner une chaîne vide.

URL téléchargeable vers une image de prévisualisation rendue à partir du modèle remeshé.

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 la prévisualisation transparente a été rendue avec succès ; sinon ce champ est omis.

Progression de la tâche. Si la tâche n'est pas encore commencée, cette propriété sera 0. Une fois la tâche réussie, cela 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ébut de la tâche, en millisecondes. Si la tâche n'est pas encore commencée, 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).