Thrixel CLI

從終端機生成 3D 模型

透過 Thrixel CLI 從文字或圖片生成模型,將檔案儲存到本機,並自動化素材工作流程。

建立模型
thrixel make '一座有梯子的木製瞭望塔' \
  --engine create \
  --tris 5000 \
  -o watchtower.glb

CLI 功能

生成

Sculpt 生成帶紋理的網格。create 引擎將部件保留為獨立、可編輯的節點。每個指令都會等待處理完成並儲存最終模型。

匯出

下載 GLB、FBX、OBJ、STL 或 USDZ,用於遊戲引擎、網頁體驗與 3D 工作流程。

腳本與 CI

JSON 輸出、獨立的進度記錄和結束代碼支援自動化。在 CI 中使用 THRIXEL_API_KEY 進行驗證。透過 thrixel run 執行個別工具。

運作方式

  1. 安裝

    需要 uv。CLI 與 MCP 伺服器一同包含在 thrixel-mcp 套件中。

    uv tool install thrixel-mcp
  2. 登入

    執行 thrixel login,開啟連結,核對代碼並核准。CLI 和 MCP 伺服器共用已儲存的憑證。

    thrixel login
  3. 預覽費用

    提交工作前,使用 --dry-run 查看規劃步驟和預估 Cubes 用量。透過 thrixel balance 查詢餘額。

    thrixel make '一座有梯子的木製瞭望塔' --engine create --dry-run

適用於程式設計代理的 Thrixel

MCP 伺服器向程式設計代理提供相同的工具。API 支援直接整合至應用程式與服務。