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, meshy-t2.5) 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 découpes. prompt est ignoré.
• by_parts : Découpe selon les parties structurelles que vous nommez dans prompt, telles que 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échargé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 prenant en charge les objets de scène (glb, obj, fbx, usdz, blend, 3mf) conservent chaque partie en tant qu'objet séparé ; stl n'a pas de notion d'objets séparés, donc il fusionne toutes les parties en un seul solide agencé selon layout (demandez 3mf pour 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 où le modèle source les avait placées.
• on_plate : Les parties sont posées à plat et étalées 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 éclat affaissé ou une pièce ponctuelle résultant d'une découpe est retiré avant l'export, afin que chaque partie obtenue soit imprimable. Les formats prenant en charge les objets de scène contiennent un objet par partie ; stl les fusionne en un seul solide.

Ajoute des connecteurs de type tenon-mortaise à chaque découpe afin que les parties imprimées s'assemblent entre elles.

La requête était inacceptable. Causes courantes :

• Prompt manquant : prompt est requis lorsque mode est by_parts ou by_color.
• Le prompt ne décrit aucune découpe, 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 faire référence à une tâche réussie d'un type pris en charge, générée avec Meshy 6 ou Meshy 7.
• Pas d'image de référence : by_color nécessite une entrée générée à partir d'une image téléchargé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.

L'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.

La découpe basée 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 à 1 et vaut 1 par défaut.

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

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 du task Auto Split à diffuser.

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

URLs téléchargeables vers le modèle divisé, une par format demandé. Les formats prenant en charge les objets de scène conservent chaque partie comme un objet séparé ; 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 divisé, avec chaque partie dans une couleur distincte, selon la layout demandée.

true lorsque le prompt d'une requête by_parts ou by_color ne nommait aucune partie, de sorte que Meshy a divisé le modèle 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 division. Les formats prenant en charge les objets de scène contiennent un objet par partie ; stl les fusionne en un seul solide, et le nombre indique toujours le nombre de parties. Les fragments effondrés que la segmentation n'a pas pu transformer en 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 de l'erreur pour les tâches ayant échoué. Consultez Erreurs pour la référence complète de l'objet task_error. Si le contrôle de sécurité du fournisseur de modèle refuse le modèle fourni, la tâche échoue avec un task_error.type invalid_input et un code provider_content_refused. Consultez Erreurs.

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.