Sand3D 來自 Sandflow,分兩部分。sand3d 是一個 Python 函式庫,用一段簡短的程式來描述 3D 物件:輪廓、實體、編輯、關節和組合件,由 Blender 的 bpy 模組運算。Sand3D 資料集是 106,094 個現有 3D 物件,被重建成 sand3d 程式,發布在 Hugging Face 上,附帶每個程式匯出的 3D 檔案和一張算圖。
它的想法是讓語言模型像寫程式碼一樣寫和編輯 3D 物件。README 說整個 API 可以放進約 3,600 個 token 的提示詞裡,而且零件用名稱來指稱(「門」「頂面」),不用手算座標。
誰做的
Sandflow,一家做程式碼驅動 3D 建模的公司。它的網站把第一個模型列為「coming soon」,並提供候補名單。函式庫的引用檔署名作者是 Thibault Neveu 和 Andréa Loy。公開發布的 1.6.3 版日期是 2026 年 11 月 6 日,Sandflow 宣布資料集的新聞稿日期是 2026 年 11 月 5 日。
我們在 2026 年 11 月 21 日查看時,GitHub 儲存庫有 2,202 顆星、241 個 fork,Sandflow 的頁面顯示資料集在 Hugging Face 上的下載量為 317,082 次。
資料集裡有什麼
五個資料集,來自 Hugging Face 上的資料集卡片:
| 資料集 | 物件數 | 帶關節 |
|---|---|---|
| sand3d-objaverse(來自 Objaverse 的日常物品) | 66,887 | 14 |
| sand3d-cad(來自公開 CAD 模型的機械零件) | 24,495 | 0 |
| sand3d-articraft(可活動的物件) | 9,209 | 9,139 |
| sand3d-simready(NVIDIA SimReady 素材) | 2,334 | 434 |
| sand3d-automate(機械組合件及其零件) | 3,169 | 869 |
| 合計 | 106,094 | 10,456 |
每一列包含物件的 sand3d 程式、程式匯出的 OpenUSD(.usda)檔(單位為公尺,Z 軸向上,帶材質,可活動的物件還帶關節)、一張算圖、一個粗略的類別(如家具、手工具),以及一個 f_score,用來衡量程式產生的形狀與原物件的接近程度。你可以在 Sand3D explorer 裡瀏覽。
這些是現有物件的重建版本,卡片把它們描述為日常物品、可活動的機構和機械 CAD 零件。關節被宣告為零件之間的鉸鏈、滑動和旋轉;沒有遊戲角色用的那種骨架或動畫片段。
免費還是收費,以及授權
目前發布的所有內容都是免費的。
- 函式庫使用 Apache License 2.0,儲存庫裡有明確說明。
- 資料集使用 CC BY 4.0(每張資料集卡片上寫的是
cc-by-4.0)。每個物件都源自第三方物件,所以那個物件自己的授權同樣適用。每一列都有source_license和attribution欄位,卡片說所有來源都是 CC-BY-4.0、Apache-2.0 或 CC0,沒有非商業或相同方式分享的。在 Objaverse 資料集中,66,275 個物件來自 CC-BY-4.0 來源,612 個來自 CC0。
所以你可以在商業遊戲裡使用這些物件,前提是保留每個物件的來源標示,以及「該物件經過修改」的說明。
怎麼用
安裝函式庫(來自 README):
pip install sand3d
Blender 以 bpy 模組的形式一併安裝:Python 3.13 上是 bpy 5.2,Python 3.11 上是 bpy 4.5。Python 3.12 沒有 bpy 的 wheel,從 bpy 5.2 起 Intel Mac 也沒有。
第一個程式,抄自 README。它建構一個安裝支架,預設單位是毫米,並匯出為 GLB:
import sand3d as s3d
def bracket(w=80, d=40, t=6, hole_d=6.6, pitch=50):
plate = s3d.extrude("plate", s3d.rect(w, d, r=4), t)
s3d.hole(plate, hole_d, on=s3d.grid(2, 1, pitch, 0))
s3d.fillet(plate, 1, edges="top")
return plate
s3d.export(bracket(), "bracket.glb")
副檔名決定格式:.glb、.urdf、.usda、.ifc、.obj 或 .stl。README 把 GLB 描述為「for the web, viewers, game engines」的格式,關節存放在每個節點的 extras 裡。sand3d 匯出的 .glb 可以用標準的 GLTFLoader 在 three.js 裡載入,和其他 glTF 檔一樣。
想讓 AI 模型來寫程式,README 說要把 docs/api.md 放進系統提示詞。對於有多個零件的物件,文件裡有撰寫組合件的八條規則。快速入門用程式碼和算圖展示了每個函式。
README 裡的洗衣機範例展示了關節的樣子:門、滾筒、洗劑抽屜和旋鈕都是有名稱的零件,四行程式碼宣告了它們怎麼運動:
s3d.joint("door_hinge", door, hinge, axis="-Z", range=(0, 143))
s3d.joint("drum_spin", drum, front.move(0, 400), kind="continuous")
s3d.joint("drawer_slide", drawer, top_band.move(150), kind="prismatic", axis="+X", range=(0, 200))
s3d.joint("dial_turn", dial, top_band.move(-150), kind="continuous")
我們在一個檔案裡發現了什麼
2026 年 11 月 21 日,我們下載了 sand3d-articraft 資料集卡片所連結的範例檔,一個小巧的相機閃光燈,沒有登入 Hugging Face:
- 這是一個純文字的 OpenUSD 檔,50,778 位元組,檔頭寫著
written by sand3d: compact_flash at rest, metres and degrees,Z 為向上軸。 - 它有 12 個命名的網格,包括
main_body、shoe_plate、三個按鈕、swivel_cylinder、tilt_pin、head_body和flash_window,合計 364 個三角形。 - 它宣告了 5 個帶限位的關節:三個可滑動 3 毫米的按鈕(
body_to_button_0到_2),一個向兩側各轉約 90 度的旋轉座(body_to_swivel),以及一個從約 -11 度傾斜到 90 度的燈頭(swivel_to_head)。 - 材質是簡單的命名顏色(
plastic__555555、steel__444444),沒有貼圖。
我們沒有為這篇指南安裝這個函式庫,所以沒有執行支架程式。注意,資料集提供的是 .usda 檔:要得到可用於 three.js 遊戲的 GLB,你需要用 sand3d 執行該物件的程式並匯出,或者用自己的工具轉換 USD 檔。
適合誰
- 讓 AI 代理建構 3D 遊戲的開發者,希望代理寫出可編輯、有名稱、參數化的模型,而不是黑盒網格。我們的 Claude Fable 5.2 Three.js 指南要求模型用程式碼產生所有模型;sand3d 是用 Python 做這件事的一種結構化方式。
- 訓練或測試寫 3D 程式碼的模型的研究人員(資料集有訓練集和驗證集切分)。
- 需要機器和可活動道具的人:門、抽屜、拉桿、輪子、帶真實關節限位的按鈕。
如果你想要現成的、風格統一的遊戲素材直接放進場景,遊戲素材庫是更短的路。
和其他資源比較
Kenney 和 Quaternius 以 CC0 發布可直接用於遊戲的素材包,不需要標示來源;Quaternius 的 FAQ 列出了 Blender 和 FBX 檔。Poly Pizza 是一個搜尋站,收錄 10,700 多個來自許多作者的免費低多邊形模型,每個模型有自己的授權,通常是 CC0 或 CC BY。Poly Haven 提供寫實的 HDRI、貼圖和模型,全部是 CC0。Sand3D 是另一類資源:它的物件是 Python 程式加匯出的 USD 檔,以 CC BY 4.0 授權並附每個物件的來源標示,為語言模型閱讀、編輯和產生而做。它沒有帶骨架的角色和動畫片段,物件也不像 Kenney 或 Quaternius 的素材包那樣被做成風格統一的一套。
來源
- 函式庫:github.com/Sandflow-ai/sand3d,包括它的 LICENSE 和給大型語言模型用的 API
- 文件:sand3d.sandflow.ai、快速入門、組合件規範
- Sandflow:sandflow.ai/sand3d
- 資料集:Hugging Face 上的 Sand3D 合集和 explorer
星數、fork 和下載數均於 2026 年 11 月 21 日核對。
做過用程式碼產生模型的遊戲?提交到 VibeGamer。



