API Auto Split

L'ID d'une tâche réussie dont le modèle doit être divisé. 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, 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, telles que la tête, les bras et le torse.
• by_color : Découpe selon les zones 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.

Formats dans lesquels exporter le modèle divisé. 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.

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 étalées sur le plateau d'impression, prêtes à être découpées en tranches — 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 pièce ponctuelle résultant d'une découpe est supprimé avant l'exportation, de sorte que chaque objet trouvé dans le fichier est imprimable.

Ajoute des connecteurs de type tenon-mortaise à chaque découpe afin que les pièces imprimées s'emboîtent.

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 telle que 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 le moment.
• 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.
• 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.

La division 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 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 k-sortable comme détail d'implémentation pour les identifiants de tâche, 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 scindé, une par format demandé. Chaque partie est un objet distinct dans le fichier. La propriété correspondant à un format sera omise si ce format n'a pas été demandé.

URL téléchargeable vers un aperçu rendu du modèle scindé, chaque partie étant d'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, si bien que Meshy a scindé 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 scindé — une par objet dans les fichiers exportés. Les fragments résiduels que la segmentation n'a pas pu transformer en pièce imprimable sont retiré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 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 é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 la charge est remboursée en cas d'échec. Supprimer une tâche alors qu'elle est encore PENDING la rembourse également.