Sand3D教程:为LLM而生的Python 3D建模语言

📌 项目日期:2026年11月 | 数据来源:GitHub官方仓库 | 星数:674+

📋 项目简介

让LLM做3D建模的瓶颈从来不是模型能力,而是token经济学:直接写Blender Python,一个部件动辄几千token还难读。Sand3D(Sandflow出品)重新设计了一层DSL:3D物体写成短程序——profiles(轮廓)、solids(实体)、edits(编辑)、frames(框架)、joints(关节)、assemblies(装配),底层跑在 Blender 的 bpy 上。同一部件省2-6倍token,且整个API只有约3600 token——整个语言直接放进提示词。

图生3D的对照路线:Idol SDK(单图高斯)、3D Model Anything(LiDAR重建)——Sand3D走的是"程序即形状"的参数化路线,改设计=改代码。

🔧 六类构造原语

原语用途
profiles截面轮廓
solids实体成形
edits倒角/开孔等修改
frames参考坐标系
joints关节连接
assemblies多部件装配

📦 使用

git clone https://github.com/Sandflow-ai/sand3d.git
pip install -e .
# 在Blender环境里用Python写sand3d程序 → bpy执行出模型
# token对比数据:https://sand3d.sandflow.ai/tokens.html

✅ 使用建议

📚 常见问题

Sand3D是什么?

一个Python 3D建模库,专为LLM设计:把3D物体写成短程序——轮廓、实体、编辑、框架、关节、装配,跑在Blender的bpy上。程序描述"形状是怎么一步步做出来的",模型几百token就能写完,人也能读懂。

比直接写Blender Python好在哪?

同一部件省2-6倍token(对比Blender Python/CadQuery/FeatureScript);整个API只有约3600 token——直接塞进提示词,模型不用检索文档。

适合什么场景?

LLM生成参数化3D资产:批量产出道具/零件/装配体,程序即规格,改参数即改设计。