lowpoly sera retiré le 30 oct. 2026. meshy-7 sera retiré en tant que modèle de génération 3D le 31 déc. 2026 ; il reste disponible en tant que modèle de texture. Changez de modèle avant ces dates pour éviter les erreurs de requête. Voir toutes les dépréciations

Intégration IA

Connectez des agents IA et des assistants de codage à Meshy, avec le Meshy CLI ou le MCP server de Meshy pour générer des modèles, ou avec llms.txt et llms-full.txt pour lire la documentation.

Si votre agent peut exécuter des commandes shell, comme Claude Code, Cursor et Codex, utilisez le CLI ou le MCP server. S'il ne se connecte aux outils que via MCP, installez le MCP server. Si votre agent de chat ne prend en charge ni l'un ni l'autre, dirigez-le vers https://docs.meshy.ai/llms.txt.


CLI ou MCP

Les deux appellent la même API REST Meshy, aux mêmes prix. Ils diffèrent par qui les exécute et comment ils se connectent.

Meshy CLIMCP server
Qui l'exécuteVous dans un terminal, des scripts, le CI, et les agents capables d'exécuter des commandes shellLes applications IA qui se connectent aux outils via MCP
ConnexionUne fois, dans votre navigateur. Une clé API est facultative, pour le CI.Une clé API dans la configuration du client
Installationnpm install -g meshy-cliUne commande ou une entrée de configuration par client (voir ci-dessous)
Idéal pourScripts, tâches par lots, CI, téléchargements et préparation pour l'impression 3DUtilisation en mode chat dans une application de chat incapable d'exécuter des commandes shell, comme Claude Desktop

Pour commencer avec le CLI, consultez Meshy CLI. Le reste de cette page couvre le MCP server.


Qu'est-ce que MCP

Le Model Context Protocol (MCP) est une norme ouverte qui permet aux assistants IA d'appeler des outils externes et d'obtenir un contexte structuré. Le MCP server de Meshy encapsule l'API REST Meshy sous forme d'outils que votre agent peut appeler. Grâce à eux, l'agent peut générer un modèle, vérifier une tâche et télécharger le résultat sans code HTTP écrit à la main.

Le MCP server est open source. Il est publié sur npm sous le nom @meshy-ai/meshy-mcp-server, et son code source se trouve dans le dépôt meshy-mcp-server sur GitHub.

Vous avez besoin d'une clé API Meshy. Créez-en une sur la page API Keys de la Developer Platform. Le MCP server la lit depuis la variable d'environnement MESHY_API_KEY.


Installer le MCP server

Pour installer le serveur, utilisez l'onglet correspondant à votre client IA. Remplacez msy_YOUR_API_KEY par votre clé API. Chaque configuration enregistre la clé dans votre configuration au niveau utilisateur, en dehors de tout projet, afin qu'elle ne se retrouve pas dans un dépôt.

# macOS / Linux / WSL
claude mcp add -s user meshy --env MESHY_API_KEY=msy_YOUR_API_KEY -- npx -y @meshy-ai/meshy-mcp-server

# Windows (PowerShell or Command Prompt)
claude mcp add -s user meshy --env MESHY_API_KEY=msy_YOUR_API_KEY "--" cmd /c npx -y @meshy-ai/meshy-mcp-server

Outils disponibles

Le MCP server propose l'API REST Meshy sous forme des outils suivants, regroupés par fonctionnalité.

Génération 3D

  • meshy_text_to_3d : crée un maillage de preview sans texture à partir d'un prompt texte
  • meshy_image_to_3d : crée un modèle 3D à partir d'une image
  • meshy_multi_image_to_3d : crée un modèle 3D à partir de plusieurs images du même objet
  • meshy_text_to_3d_refine : ajoute une texture à un maillage de preview

Post-traitement

  • meshy_remesh : modifie la topology ou le nombre de polygones d'un modèle existant, ou les deux
  • meshy_retexture : applique une nouvelle texture à un modèle existant
  • meshy_rig : ajoute un squelette à un personnage 3D humanoïde
  • meshy_animate : applique une animation à un personnage riggé
  • meshy_convert : convertit un modèle vers un autre format de fichier
  • meshy_resize : redimensionne un modèle à des dimensions réelles
  • meshy_uv_unwrap : génère une nouvelle disposition UV pour un modèle
  • meshy_text_to_motion : génère une animation à partir d'un prompt texte
  • meshy_list_animations : recherche les ID d'action des animations prédéfinies, gratuitement

Creative Lab

  • meshy_creative_lab : transforme une photo en un produit Creative Lab terminé (exécute les tâches de prototype et de build)

Génération d'images

  • meshy_text_to_image : crée une image 2D à partir d'un texte
  • meshy_image_to_image : crée une image 2D à partir d'une image de référence

Gestion des tâches

  • meshy_get_task_status : vérifie le statut d'une tâche et les URL de téléchargement
  • meshy_list_tasks : liste les tâches récentes, filtrables par type ou statut
  • meshy_cancel_task : supprime une tâche. Meshy retire et rembourse une tâche PENDING, et supprime une tâche terminée. Une tâche IN_PROGRESS ne peut pas être annulée, et l'API renvoie 409.
  • meshy_download_model : télécharge un fichier de modèle terminé et l'enregistre localement

Espace de travail

  • meshy_list_models : liste vos modèles Texte en 3D récents. Pour les autres types de tâches, utilisez meshy_list_tasks.

Impression 3D

  • meshy_send_to_slicer : trouve les slicers installés sur votre ordinateur et renvoie une commande qui ouvre le modèle dans l'un d'eux. Elle s'exécute localement et n'appelle pas l'API Meshy.
  • meshy_analyze_printability : vérifie gratuitement l'imprimabilité FDM d'un modèle, y compris l'étanchéité, le volume, les trous, les arêtes non-manifold et les faces dégénérées
  • meshy_process_multicolor : convertit un modèle texturé en un fichier 3MF multicolore pour l'impression
  • meshy_repair_printability : répare un modèle pour l'impression FDM
  • meshy_auto_split : divise un modèle en pièces imprimables séparément

Compte

  • meshy_check_balance : vérifie vos crédits restants
  • meshy_list_usage : liste les tâches API terminées de votre équipe et les crédits utilisés par chacune, pour les équipes Studio et Enterprise

Exemples de prompts

Pour commencer, essayez ces prompts dans votre chat compatible MCP :

Generate a 3D fox from the prompt "a cartoon fox sitting", preview it, then
texture it with PBR maps. Download the final GLB to ./outputs.
Take the image at https://example.com/sculpture.jpg and convert it into a
riggable 3D character. Use `should_remesh: true` and 50k target polycount.
What's my current Meshy credit balance?
List my last 10 successful text-to-3d tasks and download the top 3 as GLB
into ./downloads/.

llms.txt et llms-full.txt

Si votre agent ne prend pas en charge MCP, ou si vous souhaitez intégrer directement la documentation Meshy dans un prompt, dirigez-le vers les versions en texte brut de la documentation :

  • llms.txt : un index compact avec des instructions d'intégration, telles que comment interroger les tâches asynchrones, l'authentification, les limites de débit, le choix du modèle et les erreurs courantes.
  • llms-full.txt : toutes les pages de l'API dans un seul fichier, afin qu'un agent puisse lire la documentation en une seule requête.
  • Markdown par page : ajoutez .md à n'importe quelle URL de point de terminaison, par exemple https://docs.meshy.ai/api/text-to-3d.md.

Meshy régénère les trois à chaque build du site de documentation, afin qu'ils correspondent à la documentation HTML.


FAQ

Le MCP server est-il stateless ?
Il ne stocke pas vos identifiants. Le serveur conserve votre MESHY_API_KEY en mémoire et ne l'écrit jamais sur le disque. Par défaut, il enregistre les modèles qu'il télécharge, avec leurs métadonnées, dans un dossier meshy_output de son répertoire de travail. Pour enregistrer un téléchargement ailleurs, indiquez à l'outil de téléchargement un chemin save_to.
MCP coûte-t-il le même prix que l'API REST ?
Oui. Les appels d'outils MCP effectuent les mêmes appels REST et consomment des crédits au même taux. Consultez la page Tarification pour chaque prix.
Quelles sont les limites de débit ?
Les appels du MCP server comptent dans les mêmes limites de débit que vos appels à l'API REST. Consultez la page Rate limits pour les limites de chaque forfait.
À quelles données Meshy le MCP server peut-il accéder ?
Uniquement à ce à quoi votre MESHY_API_KEY peut accéder via l'API REST, avec les mêmes autorisations.
Comment signaler des problèmes ?
Ouvrez un ticket dans le dépôt meshy-mcp-server sur GitHub : https://github.com/meshy-dev/meshy-mcp-server/issues