API Réparer l'imprimabilité

L'ID d'une tâche réussie que vous possédez. Types de tâches pris en charge : Image to 3D, Multi-Image to 3D, Text to 3D, Remesh, Retexture et Analyze Printability. La tâche doit avoir le statut SUCCEEDED et doit avoir produit un asset GLB.

Une tâche d'analyse ayant vérifié l'épaisseur de paroi transmet également son imprimante et sa taille, de sorte que la réparation vérifie l'épaisseur de paroi et épaissit les parois fines même si vous n'envoyez ni l'un ni l'autre ; un printer_type ou une taille d'impression que vous envoyez remplace cette valeur. Les tâches d'analyse créées à partir d'un model_url .stl, .fbx, ou .gltf ne sont pas acceptées : envoyez plutôt le fichier en tant que model_url.

URL d'un modèle 3D à réparer. Formats pris en charge : .glb, .gltf, .obj, .fbx, .stl. Taille de fichier maximale : 100 Mo. Doit utiliser http, https, ou une URL data: (les URL data contournent les vérifications d'extension).

Les URL de téléchargement Meshy (assets.meshy.ai/…?Expires=…&Signature=…) sont signées et cessent de fonctionner à l'expires_at de la tâche ; récupérer à nouveau la tâche ne les renouvelle pas. Pour un modèle généré avec Meshy, transmettez plutôt input_task_id. Cela fonctionne tant que la tâche source est conservée (voir Asset Retention). Pour réutiliser un modèle après cette échéance, téléchargez-le avant expires_at et envoyez votre propre copie.

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 thumbnail_url existant reste inchangé.

L'imprimante que vous prévoyez d'utiliser. Elle définit l'épaisseur de paroi minimale visée par la réparation. Par défaut sur fdm lorsque vous envoyez une taille d'impression sans ce paramètre, sauf si une tâche d'analyse transmise comme input_task_id fournit l'imprimante.

Valeurs disponibles :

• fdm : filament, 1,0 mm de paroi minimale.
• sla : résine, 0,8 mm de paroi minimale.
• full_color : couleur complète, 2,0 mm de paroi minimale.

Hauteur de l'impression, en millimètres. Plage : [1, 1000]. Arrondi au millimètre le plus proche. Uniquement pour une entrée GLB.

Longueur du côté le plus long de l'impression, en millimètres. Plage : [1, 1000]. Arrondi au millimètre le plus proche. Fonctionne avec tous les formats d'entrée.

La requête était inacceptable. Causes courantes :

• Paramètre manquant : ni input_task_id ni model_url n'ont été fournis.
• UUID invalide : input_task_id n'est pas un UUID valide.
• URL de modèle invalide : model_url est mal formée, utilise un schéma non pris en charge, ou possède une extension de fichier non prise en charge.
• Fichier de modèle trop volumineux : le corps de model_url dépassait 100 Mo.
• Le fichier de modèle n'a pas pu être téléchargé : model_url a renvoyé une erreur, le plus souvent parce qu'une URL de téléchargement Meshy signée a expiré. Récupérer à nouveau la tâche renvoie la même URL avec la même expiration, donc envoyez votre propre copie du fichier, ou utilisez input_task_id tant que la tâche source est encore conservée.
• Tâche non réussie : la tâche référencée est encore en attente, en cours, ou a échoué.
• GLB manquant : la tâche référencée ne dispose d'aucun asset GLB à réparer.
• Taille d'impression invalide : intended_print_height_mm ou intended_print_longest_side_mm est hors de [1, 1000], ou les deux ont été envoyés.
• Type d'imprimante inconnu : printer_type n'est ni fdm, ni sla, ni full_color.
• Hauteur sur un modèle non-GLB : intended_print_height_mm a été envoyé avec un model_url qui n'est pas .glb. Utilisez intended_print_longest_side_mm à la place.
• Impossible de dimensionner ce modèle par la hauteur : à la hauteur demandée (ou la valeur par défaut de 150 mm), le côté le plus long du modèle serait hors de [1, 1000] mm, le modèle est plat, ou sa taille ne peut pas être déterminée. Utilisez intended_print_longest_side_mm à la place. Pour un model_url .glb et certaines tâches input_task_id, ceci n'est détecté qu'après le démarrage de la tâche, et la tâche se termine alors en FAILED.
• Taille STL inutilisable : printer_type a été envoyé sans taille, et le côté le plus long propre au .stl ne peut pas être lu ou est hors de [1, 1000] mm. Envoyez intended_print_longest_side_mm.

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

Causes courantes :

• Offre gratuite : la création de tâche nécessite un plan payant. Passez à un niveau supérieur sur la page d'abonnement.
• Crédits insuffisants : la limite de crédits de l'espace de travail a été atteinte.

La tâche référencée n'existe pas ou appartient à un autre utilisateur.

Vous avez dépassé votre quota de tâches en attente ou votre limite de débit.

L'ID de la tâche de réparation de l'imprimabilité à récupérer.

L'ID de la tâche de réparation d'imprimabilité à supprimer.

Numéro de page pour la pagination. Commence et vaut par défaut 1.

Limite de la taille de page. Vaut 10 éléments par défaut. Le maximum autorisé est 100 é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 réparation de l'imprimabilité à diffuser en continu.

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 faire aucune supposition sur le format de l'id.

Type de la tâche de réparation de l'imprimabilité. La valeur est print-repair.

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

Progression de la tâche. Si la tâche n'est pas encore démarrée, cette propriété sera 0. Une fois la tâche réussie, elle deviendra 100.

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'est pas encore démarré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.

Horodatage de l'expiration du résultat de la tâche dans le système, en millisecondes. 0 si la tâche n'est pas encore terminée.

Informations d'erreur si la tâche a échoué. Cette propriété est null si la tâche n'a pas échoué. Voir Erreurs pour plus de détails.

URL téléchargeables vers le modèle 3D réparé. Seul le champ correspondant au format d'entrée est renseigné ; les autres champs de format sont des chaînes vides.

URL d'une image d'aperçu générée à partir du modèle réparé.

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.

Toujours un tableau vide. La réparation ne préserve que la géométrie d'entrée et ne regénère pas les textures.

Le nombre de crédits consommés par cette tâche. 10 une fois que la tâche a atteint SUCCEEDED. Retourne 0 pour les tâches FAILED (les crédits sont remboursés en cas d'échec).

L'imprimante et la taille utilisées par la réparation, qu'elles aient été envoyées ou réutilisées depuis une tâche d'analyse. Présent dès le début (PENDING) pour une réparation d'épaisseur de paroi ; les valeurs pas encore connues sont null.

Ce qu'a fait la réparation d'épaisseur de paroi. Présent une fois qu'une réparation d'épaisseur de paroi a réussi.