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 être généré avec Meshy 6 ou Meshy 7 (ai_model meshy-6, meshy-7, ou latest). Les modèles low-poly et Smart Topology (meshy-t2) ne sont pas pris en charge.

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, 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échargée (Image en 3D ou Multi-image en 3D) ; les autres entrées sont rejetées avec 400.

Formats dans lesquels exporter le modèle découpé. Chaque partie est un objet séparé dans chaque format. glb est toujours produit et renvoyé dans model_urls ; listez tout autre format que vous souhaitez en plus.

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

3mf est écrit pour les trancheurs : un objet par partie, chacun sur son propre emplacement de filament, de sorte que Bambu Studio ouvre le fichier comme des parties colorées individuellement, sélectionnables séparément (l'archive porte une configuration de projet Bambu Studio ; les autres trancheurs lisent la géométrie). Comme les autres formats d'impression de Meshy, il est en millimètres et, comme ce point de terminaison ne prend pas de taille cible, le modèle entier est mis à l'échelle de sorte que son côté le plus long fasse 150 mm — le même plafond utilisé par les autres exports au format d'impression, choisi pour s'adapter à tous les plateaux d'impression courants. Avec layout: "on_plate", le plafond s'applique au plateau agencé dans son ensemble, de sorte que le fichier soit prêt à être tranché ; avec assembled, les parties restent où le modèle source les avait placées et vous les organisez dans le trancheur.

Comment les parties sont agencé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 réparties sur le plateau d'impression, prêtes à être tranchées — le même agencement que la vue On Plate de l'application web.

Dans les deux agencements, les fichiers exportés contiennent un objet par partie et rien d'autre : un fragment effondré ou une partie ressemblant à un point restant d'une découpe est retiré avant l'export, de sorte que chaque objet trouvé dans le fichier soit imprimable.

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

La requête était inacceptable. Causes courantes :

• Prompt manquant : prompt est requis lorsque mode est by_parts ou by_color.
• Le prompt nomme moins de deux parties : by_parts / by_color nécessite au moins deux pièces nommées (par exemple head, torso, base) ; une instruction générique comme split into individual parts 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.
• Entrée texturée : Le modèle d'entrée possède des textures. Seuls les modèles sans texture sont pris en charge pour l'instant.
• Aucune image de référence : by_color nécessite une entrée générée à partir d'une image téléchargée.
• Format non pris en charge : target_formats contient stl.
• 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 100 éléments ; les valeurs plus élevées sont ramenées à 100.

Champ utilisé 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 triable par ordre chronologique (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.

URL de téléchargement du modèle découpé, une par format demandé. Chaque partie est un objet distinct dans le fichier. La propriété pour un format sera omise si ce format n'a pas été demandé.

URL de téléchargement d'un aperçu rendu du modèle découpé, avec chaque partie dans une couleur distincte, selon le layout demandé.

true lorsque le prompt d'une requête by_parts ou by_color ne nomme aucune partie, ce qui amène Meshy à découper 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 dans le modèle découpé — une par objet dans les fichiers exportés. Les fragments effondrés que la segmentation n'a pas pu transformer en pièce imprimable sont supprimés des fichiers avant l'exportation et ne sont pas comptés.

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.

Statut de la tâche. Les valeurs possibles sont l'une de 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'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.

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