API Auto Split

L'ID d'une tâche réussie dont le modèle doit être découpé. Types de tâches pris en charge : Image en 3D, Multi-image en 3D, Texte en 3D (aperçu), Remaillage, Convertir et Redimensionner. La tâche doit avoir un statut SUCCEEDED, et son modèle doit avoir été généré avec Meshy 6 ou Meshy 7 (ai_model meshy-6, meshy-7, meshy-7.1, ou latest). Les modèles low-poly et Smart Topology (meshy-t2) ne sont pas pris en charge. Un modèle texturé est accepté, mais sa texture n'est pas conservée dans le résultat.

Comment le modèle est divisé en parties.

Valeurs disponibles :

• auto : Meshy choisit les coupes. prompt est ignoré.
• by_parts : Découpe selon les parties structurelles que vous nommez dans prompt, comme la tête, les bras et le torse.
• by_color : Découpe selon les régions de couleur que vous nommez dans prompt. Nécessite une entrée générée à partir d'une image téléversée (Image en 3D ou Multi-image en 3D) ; les autres entrées sont rejetées avec 400. Les limites des régions de couleur proviennent de l'image source, et non de la texture du modèle d'entrée. Pour Multi-image en 3D, Auto Split utilise la première image source.

Formats dans lesquels exporter le modèle découpé. Les formats qui prennent en charge les objets de scène (glb, obj, fbx, usdz, blend, 3mf) conservent chaque partie comme un objet distinct ; stl n'a pas de notion d'objets séparés, il fusionne donc toutes les parties en un seul solide organisé selon layout (demandez 3mf pour obtenir des parties sélectionnables séparément dans un trancheur). glb est toujours produit et renvoyé dans model_urls ; indiquez tout autre format souhaité en plus.

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

Comment les parties sont disposées dans chaque format de sortie, et dans la miniature.

Valeurs disponibles :

• assembled : Les parties restent à l'endroit où le modèle source les avait placées.
• on_plate : Les parties sont posées à plat et réparties sur le plateau d'impression, prêtes à être tranchées — la même disposition que la vue On Plate de l'application web.

Dans les deux dispositions, un fragment effondré ou un point résiduel issu d'une coupe est supprimé avant l'export, de sorte que chaque partie obtenue est imprimable. Les formats qui prennent en charge les objets de scène contiennent un objet par partie ; stl les fusionne en un seul solide.

Ajoute des connecteurs à tenon et mortaise à chaque coupe pour que les parties imprimées s'assemblent.

La requête était inacceptable. Causes courantes :

• Prompt manquant : prompt est requis lorsque mode vaut by_parts ou by_color.
• Le prompt ne décrit aucun découpage, ou trop de parties : by_parts / by_color accepte de 1 à 10 pièces nommées. Une description qui demande de conserver le modèle en une seule pièce, ou qui nomme plus de 10 parties, est rejetée. Rien n'est facturé.
• Tâche d'entrée non prise en charge : input_task_id doit référencer une tâche réussie d'un type pris en charge, générée avec Meshy 6 ou Meshy 7.
• Aucune image de référence : by_color nécessite une entrée générée à partir d'une image téléversée.
• Connecteur hors plage : connector_size ou connector_height est en dehors de 0.1 à 0.8.

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

Crédits insuffisants pour effectuer cette tâche.

input_task_id n'existe pas ou n'appartient pas à votre compte.

Vous avez dépassé votre limite de débit. Les requêtes by_parts et by_color partagent également une limite d'analyse de prompt de 12 requêtes par minute et par compte.

Le découpage basé sur un prompt (by_parts et by_color) est temporairement indisponible. Réessayez plus tard, ou utilisez mode: "auto", qui n'est pas affecté. Rien n'est facturé.

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

L'ID de la tâche Auto Split à supprimer.

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

Limite de la taille de page. La valeur par défaut est 10 éléments. Le maximum autorisé est de 100 éléments ; les valeurs plus élevées sont plafonnées à 100.

Champ à utiliser pour le tri. Valeurs disponibles :

• +created_at : Trier par date de création par ordre croissant.
• -created_at : Trier par date de création par ordre décroissant.

Identifiant unique de la tâche Auto Split à diffuser.

Identifiant unique de la tâche. Bien que nous utilisions un UUID k-triable 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. La valeur est print-split.

URLs téléchargeables vers le modèle découpé, une par format demandé. Les formats qui prennent en charge les objets de scène conservent chaque partie comme un objet distinct ; stl les fusionne en un seul solide. La propriété d'un format sera omise si le format n'a pas été demandé.

URL téléchargeable vers un aperçu rendu du modèle découpé, chaque partie étant d'une couleur distincte, selon le layout demandé.

true lorsque le prompt d'une requête by_parts ou by_color ne nommait aucune partie, si bien que Meshy a effectué la découpe automatiquement à la place — les noms de parties dans le résultat sont ceux de Meshy, pas les vôtres. Présent dès PENDING. Omis pour les tâches auto et chaque fois que le prompt a été suivi.

Nombre de parties imprimables produites par la découpe. Les formats qui prennent en charge les objets de scène comportent un objet par partie ; stl les fusionne en un seul solide, et le nombre continue de refléter les parties. Les fragments réduits que la segmentation n'a pas pu transformer en une pièce imprimable sont supprimés des fichiers avant l'export et ne sont pas comptabilisés.

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

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

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é vaudra 0.

Horodatage de la fin de la tâche, en millisecondes. Si la tâche n'est pas encore terminée, cette propriété vaudra 0.

Détails d'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. Toujours présent : 10 une fois la tâche acceptée, et 0 pour les tâches FAILED car le montant est remboursé en cas d'échec. Supprimer une tâche alors qu'elle est encore PENDING la rembourse également.