Meshy CLI

从命令行运行 Meshy

一条命令就能把提示词或图片变成带贴图的成品模型。

terminal — meshy
$ meshy make "girl with a pearl earring, painted bust" --dry-run
Plan 2 steps · ~30 credits
1. text-to-3d preview ~20
2. text-to-3d refine ~10
Estimates only — confirm prices at https://docs.meshy.cn/en/api/pricing and your balance with `meshy balance`.
$ meshy make "girl with a pearl earring, painted bust" -o pearl.glb
✓ [1/2] text-to-3d preview (geometry)
✓ [2/2] text-to-3d refine (textures)
✓ SUCCEEDED text-to-3d-refine
Assets glb · textures: base_color, metallic, normal, roughness · thumbnail
Saved pearl.glb

安装 meshy-cli

需要 Node.js 22.12 或更高版本。安装 CLI,登录,然后从终端开始创建。

~/your-project

bash

$ npm install -g meshy-cli

浏览器登录

在浏览器中只需登录一次,而不是把 API key 粘贴到你所使用的每个环境里。

meshy auth login

人类可读,适配 Agent

终端中的输出清晰易读。当通过管道传输或使用 --json 请求时,会生成结构化 JSON,并为自动化提供不同的退出代码。

--json

无需 Agent 也可脚本化

使用 meshy make 把提示词或图片转换为带贴图的模型。添加 -o 可在本地保存结果。

meshy make

让你的 Agent 接管 Meshy CLI

将此提示复制到你的编程 Agent 中以开始。

text

帮我安装 Meshy CLI 和 meshy-3d-agent 技能:
https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md

你在桌面端使用 ChatGPT (Codex) 吗?

打开 Plugins,搜索 Meshy,然后安装 Meshy 插件。

即将推出

Meshy 即将登陆 Claude Desktop、Muse 等的官方市场。你现在就可以通过将上面的提示发送给你的 Agent 来安装 Meshy。

也可在 ClawHub 和 Hermes Skills Hub 中使用。搜索 Meshy。

获取 OpenClaw获取 Hermes Agent

面向 MCP 用户

通过 Meshy MCP 服务器连接你的 Agent。

MCP 设置指南

常见问题

可以。在 Node.js 22.12 或更高版本下运行 npm install -g meshy-cli,然后运行 meshy auth login,通过浏览器登录。

使用生成、后处理、下载和本地工作流命令。meshy make 串联文档中列出的文本或图像流程;各端点命令和 meshy api 提供更精细的控制。CLI 和 MCP 的功能各自独立演进。

不需要。登录只会打开一次浏览器完成 OAuth 流程——不创建密钥,也不用把密钥粘贴进 shell 配置文件。CI 场景仍可改用 API 密钥。今天可用的 MCP 服务器则仍使用 API 密钥。

是的。除了浏览器流程外,还提供了用于无界面(headless)设备的 device-code 路径:CLI 会输出链接和一段短代码,让你能从任何其他设备上完成批准;另外还有手动粘贴回填(paste-back)的备用方案。

用户、脚本和 AI Agent 都可以调用 CLI。MCP 客户端调用单独安装的 MCP 服务器。两者都调用 Meshy REST API;CLI 不经过 MCP,也不依赖 MCP。

meshy-cli 与 MCP 服务器一起在 Meshy 的 GitHub 组织中以开放方式开发。