作者注：以 Qwen3.5-4B-GLB-3D-Coder 爲例，拆解“文本→Three.js→GLB”的代碼中間層工作流，並給出可落地的操作步驟。
讓大模型直接產出可用的 3D 文件，是很多獨立開發者和小型遊戲團隊都遇到過的難題。一個 4B 參數的社區微調模型給出了另一種思路：讓模型寫 Three.js 代碼，再由瀏覽器導出 GLB，把生成和導出拆成兩步。
這不是又一篇 text-to-3D 工具盤點。 Qwen3.5-4B-GLB-3D-Coder 導出的資產已能導入 Godot 編輯器，社區開發者 Naoki Kishida 還用它生成的資產做出了可遊玩的 3D RPG 演示。本文關注的是這條鏈路背後可以複用的工程方法。
核心價值：讀完本文，你將理解代碼中間層爲什麼有效，並學會在本地或雲端跑通從提示詞到 Godot 資產的完整流程。
Three.js 代碼中間層核心要點
代碼中間層是指：模型不直接輸出最終的二進制文件，而是輸出一段可以運行的程序，再由這段程序生成最終產物。在這個案例中，模型輸出的是一個獨立的 HTML 文件，其中包含 Three.js 場景和一個“Export GLB”按鈕。
| 要點 | 說明 | 對開發者的價值 |
|---|---|---|
| 模型輸出 | 單個 HTML 文件，內含 Three.js 場景與導出按鈕 | 可以直接閱讀和修改，不是黑盒文件 |
| 最終產物 | 在瀏覽器中點擊按鈕後下載 GLB | 可導入 Godot 等支持 GLB 的工具 |
| 訓練範圍 | 覆蓋角色、武器、載具、模塊化建築等 25 個遊戲資產領域 | 一個工具可覆蓋原型階段的多數佔位需求 |
| 運行方式 | 提供 Q4_K_M 與 Q8_0 兩種 GGUF 量化版本 | 可通過 LM Studio 等工具本地運行 |
| 質量定位 | 低多邊形遊戲資產，不面向寫實或影視級製作 | 適合原型、佔位和風格化項目 |
需要說明的是，Qwen3.5-4B-GLB-3D-Coder 是開發者 CCORE 基於 Qwen/Qwen3.5-4B 微調的獨立預覽版，並非 Qwen 官方發佈。按照模型卡的說法，多數生成結果首次即可使用，英文提示詞尤其如此，但部分資產仍需重試或手動修改代碼。
Three.js 代碼中間層的工作流程
整條鏈路可以概括爲六步：輸入描述、生成 HTML、保存文件、瀏覽器預覽、導出 GLB、導入引擎。其中前兩步交給模型，導出由瀏覽器中運行的代碼完成，模型不需要直接拼寫 GLB 的二進制內容。
如果資產需要運動，比如一扇會打開的門，系統提示詞會要求模型添加動畫並將其包含在導出的 GLB 中。沒有明確要求時，模型默認生成靜態資產。因此，提示詞裏要明確寫出動畫需求。
Three.js 代碼中間層的 5 個工作流啓示
下面的對比是我們基於這個案例做出的工程判斷，並非跑分結果。不同的 3D 生成方案各有適用範圍，這裏只比較兩種思路的結構性差異。
| 對比維度 | 直接生成 3D 文件 | Three.js 代碼中間層 |
|---|---|---|
| 模型輸出 | 網格或二進制資產 | 可讀的文本代碼 |
| 出錯後的處理 | 通常需要重新生成或進入建模工具修補 | 可以局部修改幾何體、材質和動畫 |
| 導出前預覽 | 依賴專門的查看工具 | 瀏覽器打開 HTML 即可查看 |
| 動畫支持 | 取決於具體的模型和管線 | 可由代碼描述，並隨 GLB 導出 |
| 擅長的範圍 | 視具體方案而定 | 結構清晰的低多邊形資產 |
| 主要侷限 | 產物不易做細粒度編輯 | 高細節或寫實資產不在設計範圍內 |
啓示一：選擇模型擅長的表示層。 編碼模型的強項是輸出結構化文本，Three.js 正好把 3D 資產轉化成了一個編程問題。這個模型只有 4B 參數，卻能承擔資產生成任務，關鍵就在於任務被轉換成了它能夠處理的形式。
啓示二：讓中間產物可以被檢查。 HTML 文件既是生成結果，也是調試入口。材質放錯或動畫循環出錯時，往往可以手動修補，不必從頭生成，這大幅降低了單次失敗的代價。
啓示三：把最後一步交給確定性工具。 文件格式的細節不必由概率模型逐字節負責。Three.js 生態本身有 GLTFExporter 這類導出能力，模型只需寫出調用導出的邏輯。一般而言，交給成熟工具的環節越多，格式層面的不確定性就越小。
啓示四：窄任務加固定約定，比泛化能力更實用。 這個模型的系統提示詞是固定的，輸出形式也被嚴格限定爲單個 HTML 文件。同時，25 個領域的訓練數據又保證了資產類型的覆蓋面。任務邊界清楚，小模型纔有足夠的發揮空間。
啓示五：在真實目的地做驗證。 瀏覽器裏好看並不代表資產可用，模型卡同時展示了導入 Godot 編輯器後的結果。作者的下一步目標也與此相關：實現可靠的一次生成，並在 Agent 框架內自動完成生成、測試和優化。
這套思路並不侷限於遊戲資產。OpenSCAD 腳本可以生成 CAD 模型，Blender Python 可以驅動建模流程，SVG 和 Mermaid 可以描述圖形與圖表。只要目標格式難以直接生成，就可以先問一句：有沒有一層代碼能夠穩定地產出它？
技術建議：如果想比較不同模型編寫 Three.js 的效果，可以通過 API易 apiyi.com 用同一套提示詞調用多個模型，再用下文的驗收清單統一評估。
Three.js 代碼中間層快速上手：本地部署
下面以 LM Studio 爲例，全程無需編寫額外代碼。LM Studio 可以直接加載 GGUF 模型，你可以在模型瀏覽器中搜索 Qwen3.5-4B-GLB-3D-Coder，也可以從 Hugging Face 下載文件後在本地加載。
第一步：選擇 GGUF 量化版本
模型卡沒有公佈精確的顯存需求，因此請結合自己的硬件實際測試。CPU 推理也可行，但速度會明顯變慢。
| 版本 | 特點 | 建議場景 |
|---|---|---|
| Q4_K_M | 文件較小，內存佔用較低，推理更快，質量有一定折損 | 筆記本 GPU、配置有限的設備、快速迭代 |
| Q8_0 | 文件較大，更接近完整精度 | 顯存充裕，希望提高複雜資產的首次成功率 |
注意版本更新：兩個量化版本都在 2026 年 11 月 2 日替換過權重，作者稱視覺質量有明顯提升，但文件名沒有變化。如果你在此之前下載過，建議刪除後重新下載，否則可能仍在使用舊版本。
第二步：配置系統提示詞與採樣參數
這個模型是圍繞特定指令格式微調的，所以建議原樣使用模型卡提供的系統提示詞，不要自行改寫：
Create game assets for the Godot editor， which uses GLB files. Create whatever the user requests as a good-quality low-poly asset using only Three.js in one complete standalone HTML file. The HTML must show the asset and include an Export GLB button that downloads a working GLB. If the requested asset needs animation， add it and include the animation in the exported GLB； otherwise make it static.
把它粘貼到 LM Studio 的系統消息欄後，再設置作者推薦的採樣參數。這些數值是作者測試時使用的起點，並非硬性要求，可以在跑通後再調整。
| 參數 | 推薦值 | 配置位置 |
|---|---|---|
temperature |
0.8 | LM Studio 生成參數 |
top_k |
40 | LM Studio 生成參數 |
top_p |
0.95 | LM Studio 生成參數 |
min_p |
0.0 | LM Studio 生成參數 |
第三步：生成並導出 GLB
用戶提示詞要簡短、具體，並儘量使用英文。可以先試 Create a blue goblin brute 或 Build a jungle siege platform；如需動畫，就寫成 Create a wooden gate with an opening animation。隨後按以下順序操作：
- 發送提示詞，等待模型輸出完整的 HTML。
- 把輸出內容另存爲
.html文件。 - 用瀏覽器打開文件，確認資產正常渲染。
- 點擊“Export GLB”按鈕，下載
.glb文件。 - 將 GLB 導入 Godot，或導入其他支持該格式的工具。
如果頁面空白，先打開瀏覽器開發者工具查看控制檯報錯。有些腳本在直接雙擊打開時可能受到瀏覽器的本地文件限制，這時可以在文件目錄下運行 python -m http.server，再通過本地地址訪問。
第四步：按清單驗收資產
不要只看瀏覽器裏的預覽效果。建議每個資產都檢查以下幾項：
- 結構：部件是否完整，有沒有明顯的錯位或穿插。
- 材質：顏色和材質在導入引擎後是否與預覽一致。
- 動畫：動畫是否真正寫入了 GLB，並能在引擎內播放。
- 尺寸與原點：比例和軸心是否符合場景需求，這部分可能需要手動調整。
- 可修復性：小問題優先改代碼，結構性問題再重新生成。
Three.js 代碼中間層雲端接入方案
代碼中間層的好處之一，是它並不綁定某個特定模型。只要模型能寫出可運行的 Three.js，就可以接入同一套流程。根據公開資料，Qwen3.5-4B-GLB-3D-Coder 目前以 GGUF 形式分發，主要用於本地推理；如果你的設備不便運行，或者想對比通用編碼模型的效果，可以走雲端 API。
API易 提供多種模型的 API 調用，兼容 OpenAI 與 Anthropic 接口格式，已有客戶端通常只需調整接口地址、密鑰和模型名。需要注意，上述微調模型是否提供雲端調用，請以模型列表的實際顯示爲準。具體配置方式可查閱 API易 文檔：docs.apiyi.com。
| 方案 | 核心特點 | 適用場景 | 費用口徑 | 可用平臺 |
|---|---|---|---|---|
| 本地微調模型 | 針對 GLB 資產微調，下載後可離線使用 | 批量生成佔位資產、需要離線運行 | 無按次調用費，需自備硬件 | LM Studio 等 GGUF 運行工具 |
| 雲端通用編碼模型 | 無需本地算力，便於切換和對比 | 設備受限、需要嘗試複雜提示詞 | 以 API易 價格頁爲準 | API易 apiyi.com 及各模型官方渠道 |
| 本地與雲端混合 | 本地跑量，疑難資產交給雲端 | 希望兼顧成本與成功率的團隊 | 雲端部分以 API易 價格頁爲準 | 本地工具配合 API 平臺 |
通過接口調用 Three.js 生成模型的步驟
- 在 API易 控制檯創建 API Key，並從文檔確認當前接口地址，不要照搬第三方教程中的地址。
- 根據現有客戶端選擇 OpenAI 或 Anthropic 接口格式，填寫
base_url與 API Key。 - 從模型列表中選擇要測試的模型，並將其名稱填入
model字段。 - 將前文的系統提示詞放入 system 消息。通用模型未經此任務微調，可以增加“只輸出完整 HTML”這類約束。
- 將響應保存爲
.html文件，後續預覽、導出和驗收步驟與本地方案相同。
LM Studio 的本地服務同樣提供 OpenAI 兼容接口。因此，你可以用同一個客戶端切換本地和雲端，只需更改接口地址和模型名。這樣一來，代碼中間層後面的預覽、導出和驗收環節都不用改動。
計費說明：模型單價、輸入輸出計費口徑和緩存價格都可能調整，本文不列具體數字，一律以 API易 價格頁的實際數據爲準：https://docs.apiyi.com/models。
常見問題 FAQ
Q1: 什麼是 Three.js 代碼中間層工作流？
它是指讓模型先編寫 Three.js 程序，由程序渲染並導出 GLB，而不是讓模型直接輸出 3D 文件。這樣可以在導出前預覽和修改結果。
Q2: Qwen3.5-4B-GLB-3D-Coder 能直接輸出 GLB 嗎？
不能。它輸出的是獨立的 HTML 文件，需要在瀏覽器中打開並點擊“Export GLB”按鈕，才能得到 GLB 文件。
Q3: 導出的 GLB 只能用於 Godot 嗎？
不是。系統提示詞以 Godot 工作流爲目標，但 GLB 是通用格式，Unity、Blender 和網頁 3D 查看器等工具也能導入。不過，導入後的效果仍需在各工具中分別驗證。
Q4: 這個模型最適合哪些應用場景？
它最適合低多邊形風格的遊戲原型和佔位資產，例如 NPC、武器、載具、模塊化建築和陷阱。如果需要高度定製的正式資產，預計仍要在導入後進行人工調整。
Q5: 沒有合適的顯卡，如何通過 API 嘗試這套流程？
可以通過 API易 apiyi.com 調用模型列表中的編碼模型，並按文檔配置 OpenAI 或 Anthropic 格式的接口。模型輸出 HTML 後，後續的預覽和導出都在本地瀏覽器中完成。
Q6: 雲端調用的費用如何計算？
不同模型的單價和計費口徑各不相同，請直接查看 API易 價格頁：https://docs.apiyi.com/models。建議先用少量提示詞試跑，再根據實際用量估算成本。
Q7: 視覺投影文件是必需的嗎？
不是必需的。可選的 BF16 視覺投影文件約 644 MiB，用於在支持 Qwen3.5 多模態 GGUF 的運行環境中輸入參考圖。如果只用文本提示詞，可以不下載。
Q8: 這個方案目前有哪些限制？
它目前是預覽版，訓練集偏重簡單提示詞，對複雜或少見需求的泛化能力有限，也不面向寫實資產。作者計劃公開數據集和 Safetensors 權重，並訓練約 10 萬條樣本、上下文長度爲 8K 到 128K tokens 的更大版本，但這些內容尚未發佈。
Three.js 代碼中間層核心要點 Key Takeaways
- 核心思路：讓模型編寫可運行的 Three.js，再由程序導出 GLB。
- 關鍵優勢：中間產物可以預覽、閱讀和局部修改，降低失敗代價。
- 本地上手：LM Studio 加載 GGUF，配合固定系統提示詞和推薦採樣參數。
- 版本提醒：11 月 2 日前下載的權重建議刪除後重新下載。
- 適用邊界：適合低多邊形原型和佔位資產，不適合寫實或影視級製作。
- 雲端路徑：可通過 API易 用 OpenAI 或 Anthropic 格式接入模型並對比效果。
- 方法外延：Blender Python、OpenSCAD 等場景也可以借鑑這種中間層設計。
總結
Qwen3.5-4B-GLB-3D-Coder 的啓發不只在於一個小模型能生成遊戲資產，更在於它重新劃分了模型與工具的職責：
- 模型負責表達：把自然語言描述轉化成結構清晰的 Three.js 代碼。
- 工具負責落地：由瀏覽器和導出邏輯生成標準的 GLB 文件。
- 驗證決定可用性：只有導入目標引擎並通過檢查，纔算真正完成。
建議先用一個簡單的靜態道具跑通全流程，再逐步測試動畫和複雜資產。如果想對比多個雲端模型，可以通過 API易 統一調用，接入方式見 docs.apiyi.com，價格以 https://docs.apiyi.com/models 的實際數據爲準。
📚 參考資料
- Qwen3.5-4B-GLB-3D-Coder 模型介紹: 模型定位、25 個資產領域與後續路線
- 鏈接：
mindstudio.ai/blog/qwen3-5-4b-glb-3d-coder-model -
說明： 適合瞭解項目的整體情況和社區案例
-
Qwen3.5-4B-GLB-3D-Coder 本地運行指南: 生成機制、量化版本與適用性分析
- 鏈接：
mindstudio.ai/blog/qwen3-5-4b-glb-3d-coder-local -
說明： 適合評估模型是否符合自己的項目需求
-
LM Studio 配置指南: 系統提示詞、採樣參數與 GLB 導出步驟
- 鏈接：
mindstudio.ai/blog/run-qwen3-5-glb-3d-coder-locally -
說明： 適合按步驟完成本地部署
-
API易 文檔與價格頁: 接口接入說明及模型價格數據
- 鏈接：
docs.apiyi.com與docs.apiyi.com/models - 說明： 接口配置和計費信息均以此處的最新內容爲準
作者: API易 技術團隊
技術交流: 接入過程中如有問題，歡迎通過 API易 官網 apiyi.com 聯繫我們，更多資料可查閱文檔中心 docs.apiyi.com
