CADAM图生3D模型实战:上传一张参考图,AI照着它复刻你的产品设计
CADAM图生3D模型实战:上传一张参考图,AI照着它复刻你的产品设计
如果你手头有一张产品参考图——一张照片、一张手绘草图,甚至是别人设计的截图——想把它变成能打印、能改尺寸的 3D 模型,CADAM 就是为此而生的开源工具。CADAM 是一个开源的 text-to-CAD(文本生成CAD)Web 应用:你上传一张参考图,AI 会"照着它"生成参数化 3D 模型,全程在浏览器里完成,不用安装任何软件,还能直接导出 STL 文件。
🚀 快速上手:三步打开 CADAM
- 打开网页:直接访问 CADAM 在线版,打开后就是上面这样的创建页,左侧是历史作品列表,中间输入框写着 "Start building with Adam…"。
- 登录:用邮箱注册/登录,新用户有免费额度可以体验。
- 输入框上传参考图:点击输入框左侧的
+图片按钮(或直接拖拽图片进去),图片会缩略显示在输入框上方。
整个过程不需要装 CAD 软件,也不需要会写 OpenSCAD 代码——这是 CADAM 最降低门槛的地方。
📤 上传参考图详解:AI 是怎么"看"你的图的
CADAM 对参考图有几条明确的格式要求(校验逻辑在 src/components/TextAreaChat.tsx):
| 项目 | 要求 |
|---|---|
| 支持格式 | JPEG / PNG / WebP |
| 最小尺寸 | 宽、高均不小于 256×256 像素 |
| 最大体积 | 单张不超过 100MB |
| 数量 | 一次对话可上传多张,AI 会同时参考 |
发送后,这些图片会被存入你的私有图片空间(存储路径规则见 shared/imageRefs.ts),服务端在生成时按 ID 从存储中取出图片,以 base64 形式交给多模态大模型"看图"——相关代码在 src/server/aiChat.ts#L1182-L1222。
一句话总结:你不需要把图片"喂给"什么接口,上传后只要正常发一句话,比如:
"照着这张图做一个 3D 模型,保持外观轮廓一致"
AI 就会结合图片内容去建模。
🔄 幕后流程:从一张图到参数化 3D 模型
很多人以为"图生3D"就是直接吐一个网格文件,CADAM 的做法更工程化,分四步(参数化模式的系统提示词定义在 src/server/aiChat.ts#L173-L329):
- 看图理解:AI 多模态模型读取你的参考图 + 文字描述,理解造型、结构和关键尺寸意图。
- 写 OpenSCAD 代码:AI 不直接画网格,而是生成一段完整的 OpenSCAD 建模代码,所有关键尺寸都声明成可调参数。
- 浏览器内编译渲染:代码在浏览器里用 OpenSCAD WebAssembly 编译,通过 Three.js 实时渲染出 3D 模型。
- 多视角自检 + 迭代:浏览器会把模型渲染成等轴测、前、后、左、右、顶、底共 7 个视角的"检查图"回传给 AI(见 src/components/chat/ChatSession.tsx)。AI 逐视角检查有没有缺失、断开、不可打印的几何体,不合格就自动重写代码再来一遍,直到每个视角都符合你的要求才收尾。
这套"生成 → 自检 → 修改"的循环,就是为什么 CADAM 出图后结构通常完整、可打印,而不是一个糊成一团的 mesh。
🎛️ 可编辑的"复刻":调参数、换颜色、一键导出
这是 CADAM 图生3D模型和普通"文生图转3D"最大的区别:生成出来的是参数化模型,不是一张图。右侧面板里,每个关键尺寸都是一个滑块(高度、底径、壁厚、扭转角度……),拖一下,模型立刻更新;颜色还能用取色器单独调整。
改完之后可以一键导出(下载入口在 src/components/viewer/DownloadMenu.tsx):
- STL:交给 3D 打印机切片软件的通用格式
- SCAD:OpenSCAD 源码,想二次修改时直接用
- DXF:2D 轮廓导出,适合激光切割
✍️ 图 + 文字组合:让 AI 复刻得更准的 3 个技巧
- 图片定"形",文字定"尺":图片负责轮廓和细节,把具体尺寸写在文字里,例如"按这张图做一个花瓶,高度 150mm,壁厚 2mm"。参考图 + 明确数值,是复刻精度最高的组合。
- 多角度图效果更好:能拿到 2~3 张不同角度的参考图时一起传,AI 对背面、侧面结构的推断会准确很多。
- 先粗后细迭代:第一版先确认大轮廓,再用对话微调,比如"把手再粗一点""底部加一个 5mm 的底座"——AI 会在原模型基础上修改,而不是推倒重来。
💡 小技巧:参数名会被 AI 写成完整英文单词直接显示在面板上(如
vase_height),如果你希望面板上出现某个参数,可以在描述里明确提到它。
🏁 小结
CADAM 把"图生3D模型"做成了普通用户也能上手的流程:上传参考图 → 说一句话 → AI 看图建模 → 多视角自检 → 参数化模型落地,再配合滑块改尺寸、导出 STL 进打印机。项目内置的 benchmarks/ 目录里还有 13 个从一句话到完整机械结构的示例(螺栓、齿轮箱、涡扇发动机等),值得对照着感受它的上限。
对开发者而言,仓库采用 React + TanStack Start + Supabase + OpenSCAD WASM 技术栈,核心源码集中在 src/server/(AI 对话与网格生成)与 src/components/(上传、预览、下载),想本地跑起来只需 Node.js 20.19+,通过 git clone https://gitcode.com/gh_mirrors/ca/CADAM 获取代码后按 README.md 的 Quick Start 配置环境变量即可。



