sand3d(LLM写3D)

作者 AI脉搏

让大模型写 3D 模型,最痛的是它得先啃会 Blender 那一大套 API,几个 token 就烧完了。sand3d 把 3D 建模写成短程序,同一个零件比 Blender Python 省 2 到 6 倍 token,整个 API 只占约 3,600 token,能一次塞进 prompt。

Github
项目 创作设计 v1.0.0 热度 300

项目说明

sand3d 是什么

sand3d 是一个 Python 库,用「短程序」的方式描述 3D 物体:轮廓(profiles)、实体(solids)、编辑(edits)、坐标框架(frames)、关节(joints)和装配体(assemblies),底层跑在 Blender 的 bpy 之上。

它和传统建模脚本的关键差别是「说清怎么造」而不是「算出一堆顶点」。一个程序按零件逐段描述形状,所以模型用几百个 token 就能写完,人类也能读懂。

对比项sand3dBlender PythonCadQuery / FeatureScript
同等零件的 token 用量少 2–6 倍基线基线
整个 API 能否塞进 prompt能,约 3,600 token不能不能
表达方式命名式(named, not computed)计算式计算式
导出格式GLB、URDF、USD、IFC、OBJ、STL需插件有限

导出格式覆盖 GLB、URDF、USD、IFC、OBJ、STL,既能进渲染管线,也能直接给机器人仿真用。官方另外提供数据集和 Explorer 供参考。

sand3d 怎么安装

pip install sand3d

在 uv 项目里:

uv add sand3d

sand3d 怎么使用

  1. 先写一个最小零件跑通,确认 bpy 环境正常。
  2. 按「轮廓 → 实体 → 编辑」的顺序描述形状,别一上来就写复杂装配体。
  3. 多个零件用 frames 定位、joints 连接,最后组装成 assemblies。
  4. 要交给 LLM 写,把那份 3,600 token 的 API 说明整段放进 prompt,让它照格式写。
  5. 导出按用途选:渲染用 GLB/OBJ,机器人仿真用 URDF,工程交换用 IFC/STEP 系格式。

sand3d 适合谁用

  • 想让大模型直接产出 3D 模型的开发者——它为 LLM 省 token 是设计目标。
  • 做参数化零件、装配体,希望代码可读可改的工程师。
  • 需要从模型直接导出 URDF 做机器人仿真的团队。
  • 已经在用 Blender、想用编程替代手工建模的人。
  • 要做影视级手工雕刻、复杂曲面造型的场景,代码建模不是好选择。

sand3d 项目地址

  • GitHub 仓库:https://github.com/Sandflow-ai/sand3d
  • 项目官网:https://sand3d.ai
  • API 说明:https://github.com/Sandflow-ai/sand3d/blob/main/docs/api.md