Meshy 3D — Génération + Impression

Que fait Meshy 3D — Génération + Impression ?

Utilisez la CLI Meshy 0.8 (0.8.5 ou ultérieure) pour transformer la demande de l'utilisateur en un livrable : les fichiers demandés dans l'emplacement demandé, un aperçu inspecté lorsqu'il existe, et — pour les impressions — la taille prévue, les résultats d'analyse/réparation et un transfert vers le slicer si demandé. La connexion ou la soumission de tâche seule ne constitue pas un achèvement. Choisissez le pipeline le plus court adapté et réutilisez les actifs existants pour les suivis.

MANIFESTE DE SÉCURITÉ

Exécutables : la CLI Meshy — meshy, ou le paquet temporaire épinglé npm exec --yes [email protected] -- meshy — plus npm pour l'installer, node --version pour vérifier l'environnement d'exécution. Pas de Python, pas de curl, pas de scripts fournis.

Informations d'identification : la connexion par navigateur propre à la CLI (flux OAuth sur appareil) stocke et rafraîchit une session dans ~/.config/meshy/credentials.v2.json (mode 0600), chiffrée avec une clé gérée par le système d'exploitation. Une MESHY_API_KEY existante, ou un --api-key-file explicite, est honorée et prend la priorité. La compétence ne lit, n'affiche ni ne copie jamais de jeton, de code d'appareil ou de clé, et n'en demande jamais dans le chat. MESHY_API_KEY est facultatif.

Réseau : l'API Meshy (api.meshy.ai) et sa page de connexion (www.meshy.ai), ou api.meshy.cn et meshy.cn pour le site Chine ; les hôtes de médias des actifs en cours de téléchargement ou des URL d'entrée vérifiées, sans les informations d'identification ; le registre npm lorsque la CLI est installée ou exécutée en tant que paquet temporaire.

Fichiers : écrit uniquement dans un espace de travail par tâche — le répertoire nommé par l'utilisateur, ou ./meshy_output — et la CLI refuse les chemins qui en sortent, y compris par les liens symboliques. Les fichiers existants ne sont pas écrasés sauf si l'utilisateur le demande. Lit les fichiers d'entrée pointés par l'utilisateur et ses propres sorties dans l'espace de travail (aperçus, fichiers auxiliaires). Le transfert vers le slicer lance une application de slicer déjà installée.

Données quittant cette machine : les invites, les images/modèles d'entrée et les requêtes de tâches envoyées à Meshy.

Lire ce dont cette demande a besoin

Besoin	Référence
Exécuteur de la CLI, connexion ou emplacement de sortie	Configuration
Actifs numériques : génération et les modèles à associer pour un projet, texturage, remaillage, conversion, images	Pipelines
Rigging, animation ou mouvement généré	Animation
Impressions physiques : préparation locale, génération d'impression, analyse/réparation, slicers	Recettes d'impression
Produits Creative Lab (figurines, lampes, porte-clés, aimants, keycaps, gadgets)	Creative Lab
Coût, attente, aperçu, livraison ou recherche d'un modèle précédent	Livraison
Opération échouée ou incertaine	Dépannage

Lisez la section pertinente lorsque nécessaire ; les recettes sont des exemples à adapter, pas des étapes à exécuter entièrement. Un modèle non texturé ignore le texturage ; un GLB existant n'a pas besoin de conversion. Utilisez l'option --help d'une commande lorsque les paramètres sont incertains.

Actif numérique ou impression physique

Tout ce qui est destiné à être imprimé — une impression, un slicer, du 3MF, du STL, Bambu/Orca/Prusa/Cura, multicolore, un jouet de bureau ou une figurine physique — suit les Recettes d'impression dès la première commande, afin que les paramètres de génération correspondent à l'impression. Tout le reste suit les Pipelines.

Demande d'impression	Chemin
Mettre à l'échelle, orienter ou poser au sol un OBJ existant	mesh prepare-print local ; pas de connexion ni de solde
Ouvrir un STL ou 3MF existant	slicer detect et slicer open local ; pas de connexion ni de solde
Modèle blanc à partir d'une photo, d'un croquis ou d'un texte	Photo : image-vers-3d. Sinon recommander d'abord une image de référence (multi-vue quand la profondeur ou les côtés importent), avec texte-vers-3d comme alternative plus rapide ; géométrie sans textures ; analyser/réparer si nécessaire ; préparer le fichier
Modèle multicolore	Générer/réutiliser la géométrie ; analyser/réparer si nécessaire ; texturer ; impression-multicolore
Imprimer en pièces séparées (plateau de construction, couleurs par pièce, moins de supports)	Générer/réutiliser la géométrie ; découpage automatique ; slicer les pièces
Vérifier ou réparer un modèle existant (trous, parois fines), tout format	Analyse-gratuite d'imprimabilité par ID de tâche ou --model-url ; réparer seulement si nécessaire
Redimensionner un STL, 3MF ou GLB existant	Le mettre à l'échelle dans le slicer ; seul un OBJ est redimensionné localement
Figurine Creative Lab (collectionnable stylisé à partir d'une photo), figurine vinyle, figurine en briques, lampe, porte-clés, aimant pour frigo, keycap ou tableau de gadgets pixel	Prototype → validation → construction → sélection des artefacts du produit
Gadget pliable Creative Lab	Une création à partir de la photo → STL

Les chemins de couleur diffèrent : le multicolore peint la surface d'un objet pour une imprimante multi-matériaux ; une découpe le divise en parties, un filament chacune, et supprime la texture (découper avant toute réparation ; les deux ne s'enchaînent pas) ; le tableau de gadgets pixel est un produit en soi.

Une figurine seule n'implique pas Creative Lab. Demandez la taille, la couleur ou le style uniquement lorsque le choix manquant modifie considérablement le résultat.

Première utilisation et connexion sur OpenClaw

Avant la première commande, exécutez meshy --version ; pas besoin de demander. Lorsque meshy est manquant ou plus ancien que 0.8.5, installez la version 0.8.x la plus récente avec npm install -g [email protected] et dites-le en une ligne ; la Configuration couvre une installation refusée et une CLI de version 0.9 ou ultérieure. Le travail d'impression uniquement local s'arrête là. Tout le reste réutilise une session auth status vérifiée ; uniquement lorsqu'il n'y en a pas, connectez-vous :

1. Démarrez meshy auth login --device --format json --no-update-check (ajoutez --region cn pour un utilisateur en Chine continentale : le même compte et crédits que le site global) avec exec et un court yieldMs (environ 3000) et timeoutSeconds: 900, afin qu'il continue de s'exécuter en arrière-plan et renvoie un sessionId.
2. La CLI affiche Saisissez le code … sur https://www.meshy.ai/device sur stderr en quelques secondes. Si la première sortie ne contient que des avis npm, process poll ce même sessionId. Envoyez à l'utilisateur l'URL sous forme de lien et le code textuellement, ainsi que la marche à suivre : l'ouvrir, se connecter à Meshy si demandé, taper le code, approuver. Rien ne doit être renvoyé dans le chat.
3. Ne démarrez pas une deuxième connexion, ne tuez pas la session, et ne faites pas vous-même un sondage HTTP ; la CLI attend l'approbation. Lorsqu'elle se termine, OpenClaw réveille cette session ; récupérez le résultat avec process poll (un sous-agent, qui n'obtient pas de réveil, sonde avant de céder). Ensuite, vérifiez auth status et continuez la demande initiale avec les entrées, le chemin et le budget déjà donnés.

Une session en arrière-plan ne doit pas être détachée avec & ou nohup. Un code expiré ou refusé signifie relancer la même connexion ; cela ne justifie jamais de réexécuter une tâche payante. Les commandes wait longues se comportent de la même manière : laissez exec les mettre en arrière-plan et reprenez du réveil d'achèvement, plutôt que de soumettre à nouveau ou de boucler avec sleep.

Seule la CLI touche son répertoire de configuration ; une connexion bloquée par un bac à sable suit la Configuration, section 3.

Limites d'exécution

• Exécutez les opérations API, de téléchargement, de téléversement et de maillage via la CLI. Les entrées locales ont une limite de 50 Mio, et un modèle local doit être au format GLB ou glTF (rigging, dépliage UV et multicolore : GLB) ; utilisez la route d'entrée par URL pour tout le reste.
• Chaque commande utilise --format json --no-update-check et affiche une enveloppe meshy.cli/v1, connexion incluse. Résolvez WORKSPACE à partir du chemin de sortie de l'utilisateur et transmettez-le à chaque écriture.
• Sachez à quoi sert le modèle avant la première création payante : un actif de jeu, un personnage à rigger, un rendu, une impression 3D. Si l'utilisateur ne l'a pas dit, demandez une fois ; la réponse choisit le chemin et les modèles (Pipelines). Un actif de jeu ou un budget de nombre de faces signifie une topologie intelligente, pas un modèle standard remaillé.
• Soumettez une fois avec create --async, conservez la ressource propriétaire et l'ID de tâche, puis wait sur cette tâche. Les dépassements de délai et les soumissions inconnues suivent le Dépannage ; ils n'autorisent jamais une autre création payante.
• Sans photo utilisable, recommandez de créer d'abord une image de référence et de construire le modèle à partir de celle-ci ; texte-vers-3d est l'alternative plus rapide (Pipelines, Démarrer à partir d'une image ; impressions : Recettes d'impression, section 1).
• Travaillez dans le cadre et le budget approuvés ; proposez des étapes payantes supplémentaires ou des ré-exécutions avant de dépenser. La préparation locale et l'analyse d'imprimabilité sont gratuites ; la Livraison couvre les estimations.
• La réparation modifie la géométrie et supprime les textures : utilisez la géométrie réparée en aval et retexturez avant la sortie multicolore. Préparez un OBJ orienté Y vers le haut une fois, en tant que nouveau fichier ; n'appliquez jamais cette transformation aux sorties STL, 3MF ou de produit en relief.

Livrer

Téléchargez uniquement les actifs nécessaires. Envoyez à l'utilisateur un aperçu rendu disponible sous forme d'image ; une absence d'aperçu est indiquée, jamais implicite, et un PNG rendu n'est pas un visualiseur 3D. Rapportez les chemins de fichiers, les ID de tâches pour les suivis et le coût réel. Pour les impressions, rapportez également les dimensions et le statut de l'analyse/réparation ; lancez un slicer détecté uniquement sur demande, et notez que launch_requested ne prouve pas que le modèle a été importé. Mentionnez les vérifications restantes pertinentes, telles que les supports et l'épaisseur de paroi, sans qualifier un modèle non testé d'imprimable garanti.