Auto Split API

L'ID de la tâche dont le modèle doit être découpé. La tâche doit avoir le statut SUCCEEDED. Ces types de tâches fonctionnent :

• Image en 3D
• Multi-image en 3D
• Texte en 3D, une tâche preview ou refine
• Retexturisation
• Remaillage
• Convertir
• Redimensionner

Le modèle doit avoir été généré avec Meshy 6 ou Meshy 7, c'est-à-dire avec ai_model défini sur meshy-6-lite, meshy-6, meshy-7, meshy-7.1, ou latest. Les modèles Smart Topology (meshy-t2 et meshy-t2.5) ne sont pas pris en charge. Pour une tâche refine, Retexturisation, Remaillage, Convertir ou Redimensionner, la règle s'applique au modèle à partir duquel la tâche a démarré. Une tâche Retexturisation, Remaillage, Convertir ou Redimensionner créée à partir d'un modèle importé renvoie 400.

Le modèle peut avoir au maximum 8 000 000 de faces. Un modèle avec plus de faces renvoie 400. Dans ce cas, exécutez d'abord une tâche de Remaillage dessus, puis envoyez l'ID de la tâche de Remaillage à la place.

Vous pouvez découper un modèle texturé. Pour conserver sa texture sur les parties, envoyez keep_texture: true.

Comment diviser le modèle en parties.

Valeurs disponibles :

• auto : Meshy choisit les découpes et ignore prompt. Un prompt de plus de 600 caractères renvoie quand même 400.
• by_parts : Meshy découpe selon les parties structurelles que vous nommez dans prompt, par exemple tête, bras et torse.
• by_color : Meshy découpe selon les zones de couleur que vous nommez dans prompt. Meshy trouve les zones dans l'image source, pas dans la texture du modèle d'entrée. L'entrée doit être générée à partir d'une image importée, avec Image en 3D ou Multi-image en 3D. Les autres entrées renvoient 400. Pour Multi-image en 3D, Meshy utilise la première image source.

Les formats de fichier à générer. Meshy génère toujours glb et le renvoie dans model_urls, ainsi que les autres formats que vous listez.

Valeurs disponibles :

• glb
• obj
• fbx
• stl
• usdz
• blend
• 3mf

Chaque format sauf stl prend en charge les objets de scène et conserve chaque partie comme un objet distinct. Un fichier STL ne peut pas contenir des objets distincts, donc Meshy fusionne les parties en un seul solide, disposé selon layout. Pour obtenir des parties que vous pouvez sélectionner séparément dans un trancheur, demandez 3mf.

Avec keep_texture: true, ces formats conservent la texture :

• glb, fbx, usdz, et blend : La texture est dans le fichier.
• obj : La texture est dans le fichier de matériau, que model_urls renvoie sous mtl.
• stl et 3mf : Le fichier ne contient que la géométrie, sans la texture.

Comment Meshy dispose les parties, dans chaque format de fichier et dans la miniature.

Valeurs disponibles :

• assembled : Meshy conserve les parties à leur emplacement dans le modèle source.
• on_plate : Meshy pose les parties à plat et les répartit sur le plateau d'impression, prêtes à être tranchées. Il s'agit de la même disposition que la vue On Plate dans l'application web.

Dans les deux dispositions, Meshy supprime tout fragment effondré ou en forme de point laissé par une découpe avant l'exportation, afin que chaque partie obtenue soit imprimable. Les formats qui prennent en charge les objets de scène conservent un objet par partie, et stl fusionne les parties en un seul solide.

Indique s'il faut conserver la texture du modèle d'entrée sur les parties. true donne à chaque partie la texture de l'entrée, et la tâche renvoie les cartes dans texture_urls. false donne à chaque partie une couleur de sommet uniforme.

Avec true, la tâche prend environ deux fois plus de temps, et le coût en crédits ne change pas. Une entrée non texturée se découpe de la même manière qu'avec false. Si Meshy ne peut pas conserver la texture, la tâche échoue avec le code d'erreur textured_split_refused. Voir Erreurs.

Indique s'il faut ajouter des connecteurs de type tenon-mortaise à chaque découpe, pour que les parties imprimées s'assemblent.

La requête ne peut pas s'exécuter. Le message d'erreur indique quel problème a été détecté. Par exemple :

• Prompt manquant : mode est by_parts ou by_color, et prompt est absent.
• Le prompt ne décrit aucune découpe, ou trop de parties : Le prompt demande de garder le modèle en une seule pièce, ou nomme plus de 10 parties. by_parts et by_color acceptent de 1 à 10 parties nommées. Meshy ne facture pas la requête.
• Tâche d'entrée non prise en charge : input_task_id n'est pas 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 : mode est by_color, et l'entrée n'a pas été générée à partir d'une image importée.
• Connecteur hors plage : connector_size ou connector_height est en dehors de 0.1 à 0.8.

Corrigez la requête, puis renvoyez-la. Voir Erreurs.

La clé API est manquante ou invalide. Vérifiez l'en-tête Authorization.

Par exemple :

• Crédits insuffisants : Le compte n'a pas assez de crédits pour cette tâche, ou le compte a atteint une limite de crédits. Vérifiez votre solde de crédits, puis réessayez.
• Forfait gratuit : La création d'une tâche nécessite un forfait payant. Mettez à niveau votre forfait dans vos paramètres d'abonnement, puis réessayez.

L'un des cas suivants s'applique :

• La modération de contenu a bloqué le prompt. Le message est explicit content ou prohibited content. Modifiez le prompt, puis réessayez.
• input_task_id est un modèle en bas-relief, que ce point de terminaison ne peut pas découper. Le message est This model type does not support this operation. Envoyez un autre modèle.

input_task_id n'existe pas ou n'appartient pas à votre compte. Vérifiez l'ID, et utilisez une clé API du compte qui a créé la tâche.

Vous avez dépassé votre limite de débit. Patientez, puis réessayez. Voir Limites de débit.

Les requêtes by_parts et by_color partagent également une limite de lecture de prompt de 12 requêtes par minute et par compte.

Le découpage par prompt (by_parts et by_color) est temporairement indisponible. Réessayez plus tard, ou envoyez mode: "auto", qui fonctionne toujours. Meshy ne facture pas la requête.

L'ID de la tâche provenant de la réponse de création.

L'ID de la tâche à supprimer.

Le numéro de page à retourner. Commence à 1 et vaut 1 par défaut.

Le nombre de tâches par page, jusqu'à 100. La valeur par défaut est 10. Meshy traite une valeur plus grande comme 100.

L'ordre de tri.

Valeurs disponibles :

• +created_at : du plus ancien au plus récent
• -created_at : du plus récent au plus ancien

L'ID de la tâche provenant de la réponse de création.

L'ID de la tâche. Traitez-le comme une chaîne opaque, et ne vous fiez pas à son format.

Le type de tâche, toujours print-split.

URLs de téléchargement pour le modèle divisé, une par format que vous avez demandé. Un format que vous n'avez pas demandé n'a pas de clé. Les formats qui prennent en charge les objets de scène conservent chaque pièce comme un objet séparé, et stl fusionne les pièces en un seul solide.

URL de téléchargement pour une image d'aperçu du modèle divisé, dans la layout que vous avez demandée. Quand les pièces conservent une texture, l'aperçu la montre. Sinon, chaque pièce a sa propre couleur.

Les cartes de texture du modèle divisé, sous forme de tableau avec un objet. Toutes les pièces partagent ces cartes. Présent uniquement quand keep_texture est true et que le modèle d'entrée possède une texture.

URL de téléchargement pour une version de thumbnail_url avec un arrière-plan transparent (RGBA). Présent uniquement après la réussite de la tâche, quand Meshy a rendu l'aperçu transparent.

Indique si Meshy a ignoré le prompt. C'est true quand le prompt d'une requête by_parts ou by_color n'a nommé aucune pièce, donc Meshy a divisé le modèle automatiquement à la place. Les noms de pièces dans le résultat sont alors ceux de Meshy, pas les vôtres. Présent à partir de PENDING. Meshy l'omet pour les tâches auto et chaque fois qu'il a suivi le prompt.

Le nombre de pièces imprimables que la division a produites. Les formats qui prennent en charge les objets de scène contiennent un objet par pièce. stl fusionne les pièces en un seul solide, mais part_count les compte quand même. Avant l'export, Meshy supprime les fragments effondrés qui ne peuvent pas devenir une pièce imprimable, et ne les compte pas.

La part de la tâche réalisée, en pourcentage. C'est 0 jusqu'à ce que la tâche démarre et 100 quand elle réussit.

Le statut de la tâche, l'un de PENDING, IN_PROGRESS, SUCCEEDED, FAILED, ou CANCELED.

Le nombre de tâches devançant celle-ci dans la file d'attente. La valeur n'est significative que pendant que la tâche est PENDING.

Heure de création de la tâche, en millisecondes Unix.

Heure de démarrage de la tâche, en millisecondes Unix. C'est 0 jusqu'à ce que la tâche démarre.

Heure de fin de la tâche, en millisecondes Unix. C'est 0 jusqu'à ce que la tâche se termine.

Heure d'expiration du résultat de la tâche, en millisecondes Unix. C'est 0 jusqu'à ce que la tâche se termine.

Les détails de l'erreur en cas d'échec de la tâche. Voir Erreurs.

Si un contrôle de sécurité rejette le modèle d'entrée, la tâche échoue avec task_error.type défini sur invalid_input et task_error.code défini sur provider_content_refused. Envoyez un modèle différent. Voir Erreurs.

Avec keep_texture: true, si Meshy ne peut pas conserver la texture, la tâche échoue avec task_error.code défini sur textured_split_refused. Voir Erreurs.

Le nombre de crédits utilisés par la tâche. Il est toujours présent. C'est 10 après que Meshy a accepté la tâche, et 0 pour une tâche FAILED, car Meshy rembourse les crédits quand une tâche échoue. Supprimer une tâche PENDING la rembourse aussi.