用于Copilot的Meshy AI
一个VS代码扩展,它公开 梅希艾 3D生成API GitHub Copilot语言模型工具,因此您可以在代理模式下直接从Copilot聊天中生成、重新混合和重新网格化3D游戏资产。
需求
- VS代码1.99或更高版本
- 启用代理模式的GitHub Copilot扩展
- A. 梅希艾 帐户和API密钥
安装
下载最新版 .vsix 从 并将其安装在VS Code中。
Windows注意事项: 不要双击 .vsix 文件——打开Visual Studio安装程序,该安装程序无法安装VS Code扩展。请改用以下方法之一。选项1--VS代码用户界面:
- 打开VS代码
- 转到“扩展”视图(
Ctrl+Shift+X) - 点击
...“扩展”面板右上角的菜单 - 选择 从VSIX安装。..
- 浏览到已下载的
.vsix并选择它
选项2——命令行:
code --install-extension meshy-mcp-.vsix入门指南
安装扩展后,设置Meshy API密钥:
- 按
Ctrl+Shift+P然后跑 Meshy:设置API密钥 - 粘贴密钥(以开头
msy_)然后按Enter键
扩展会自动激活,无需编译或设置。在代理模式下打开Copilot聊天,Meshy工具将立即可用。
可用工具
| 工具 | 它做什么 |
|---|---|
meshy_preview | 提交文本到3D预览任务并返回任务ID |
meshy_refine | 将PBR纹理添加到已完成的预览任务中 |
meshy_status | 检查任何任务的状态和进度 |
meshy_download | 将GLB从已完成的任务下载到本地路径 |
meshy_generate | 完整管道:预览→ 精炼→ 一步下载 |
meshy_generate_from_file | 批量处理JSON资产文件,从停止的地方继续 |
meshy_balance | 查看您当前的Meshy.ai余额 |
meshy_image_to_3d | 从单个参考图像生成3D模型 |
meshy_multi_image_to_3d | 从多个参考图像(正面、侧面、背面等)生成3D模型 |
meshy_retexture | 将新的AI生成的纹理应用于现有的3D模型 |
meshy_remesh | 清理几何图形、重新定位或转换3D模型的格式 |
您可以使用以下工具直接在Copilot聊天中引用这些工具 #meshy_generate, #meshy_status等,或者简单地描述你想要什么,Copilot将调用相应的工具。
配置
这些设置可以在VS代码设置中更改(Ctrl+,)under 网状:
| 设置 | 说明 | 默认值 |
|---|---|---|
meshy.apiKey | 您的Meshy.ai API密钥 | _(无)_ |
meshy.pollIntervalSeconds | 多久轮询一次任务完成情况 | 10 |
meshy.defaultStyleSuffix | 附加到每个生成提示的文本 | _(无)_ |
meshy.defaultNegativePrompt | 负面提示适用于所有世代 | _(无)_ |
批量生成:资产文件格式
meshy_generate_from_file 读取一个描述要生成的资产列表的JSON文件。该格式反映了 generate_meshy_assets.py 脚本:
{
"settings": {
"style_suffix": ", low-poly game asset, PBR",
"negative_prompt": "blurry, watermark"
},
"assets": [
{
"id": "Tier1/air_intake_pump",
"output_path": "Assets/Models/Tier1/air_intake_pump.glb",
"prompt": "An industrial air intake pump"
},
{
"id": "Tier1/pressure_valve",
"output_path": "Assets/Models/Tier1/pressure_valve.glb",
"prompt": "A brass pressure relief valve",
"image_url": "https://example.com/reference.jpg"
}
]
}进度字段(preview_id, refine_id, done)在每个步骤后都会写回文件,因此中断的运行会从中断的位置自动恢复。
您可以使用 only 按ID处理资产子集的参数(部分匹配):
_“在assets.json上运行meshy_generate_from_file,但只处理Tier1/air_intake_pump”_
使用 dry_run: true 以便在不进行任何API调用的情况下预览将要处理的内容。
信贷成本
在进行任何消耗信用的API调用之前,扩展将显示一个确认提示。
| 运营 | 成本 |
|---|---|
| 预览(文本到3D,网格-6) | 20学分 |
| 优化/PBR纹理 | 10学分 |
完整管道(meshy_generate) | 30学分 |
| 图像到3D——无纹理 | 20学分 |
| 图像到3D——带纹理 | 30学分 |
| 多图像转3D——无纹理 | 20学分 |
| 多图像到3D——带纹理 | 30学分 |
重新掺合料(meshy_retexture)10学分 | |
记住(meshy_remesh) | 5学分 |
检查余额(meshy_balance) | 免费 |
每次操作前,信用成本都会显示在确认对话框中。对于批量运行,所有待处理资产的总成本都会预先显示。
链接
- 梅希艾 -创建帐户并获取API密钥
- Meshy API文档 -API参考
- --下载最新
.vsix - 贡献 --从源代码构建并提交更改
