Trellis Blender

🚀 TRELLIS Blender 插件

這是一款強大的 Blender 插件，它將 TRELLIS 的 3D 生成能力完美集成到 Blender 中。TRELLIS 作為 SOTA 文本到 3D 和圖像到 3D 的 AIGC 模型，讓這款插件擁有了卓越的 3D 生成能力。現在，它還更新支持了文本到 3D 和 MCP 集成。

🚀 快速開始

安裝

先決條件

• Blender 3.6.0 或更高版本
• 運行 TRELLIS API 服務器（參見 我的 TreLLIS 分支）

啟用插件

1. 下載插件文件（克隆此倉庫）
2. 在 Blender 中，轉到編輯 > 偏好設置 > 插件
3. 點擊“安裝”，並選擇 trellis_for_blender.py 文件
4. 通過在“3D 視圖：TRELLIS”旁邊的複選框中勾選來啟用插件

工作流程

原生工作流程

1. 訪問面板（打開 3d 視口，按 n 打開側邊欄），找到 TRELLIS。
2. （可選）在場景中選擇一個對象，選擇一個作為條件輸入的圖像。
3. 調整生成參數（經驗上可以使用更少的步驟）
4. 插件會將所選的對象和圖像/文本上傳到 API 後端。
5. 完成後，模型可以下載並導入到場景中。

你可以在主面板中查看歷史請求

MCP 工作流程

1. 訪問面板（打開 3d 視口，按 n 打開側邊欄），找到 TRELLIS，點擊啟動 MCP 服務器
2. 打開 Claude/Cursor/Windsurf，粘貼以下配置：

"mcpServers": {
        "trellis": {
            "command": "uvx",
            "args": [
                "trellis-mcp"
            ]
        }
    }

✨ 主要特性

• 文本到 3D：文本 -> 帶紋理的 3D 網格
• 圖像到 3D：圖像 -> 帶紋理的 3D 網格
• 文本條件細節變體：文本 + 3D 網格 -> 帶紋理的 3D 網格
• 圖像條件細節變體：圖像 + 3D 網格 -> 帶紋理的 3D 網格
• MCP 集成：與 MCP 集成，並能與 Cursor/Windsurf 通信。
  參考 Trellis MCP

📚 詳細文檔

生成參數

• 稀疏結構設置
  • 採樣步驟（結構擴散的採樣步驟，默認 12）
  • CFG 強度（無分類器自由指導，默認 7.5，更高的值將更好地對齊輸入圖像）
• 結構化潛在設置
  • 採樣步驟（SLAT 擴散的採樣步驟，默認 12）
  • CFG 強度（無分類器自由指導，默認 7.5，更高的值將更好地對齊輸入圖像）
• 後處理網格選項
  • 簡化比例（要移除的三角形數量，默認 0.95）
  • 紋理大小（默認 1024，可以設置為 2048 以獲得更高質量，但速度較慢）
  • 紋理烘焙模式（'fast' 或 'opt'，'opt' 雖然速度較慢，但質量更高）

功能特性

• 異步請求處理
• 即時狀態更新
• 錯誤處理
  • "未選擇文件"：請選擇輸入圖像
  • "API 連接錯誤"：檢查 API 服務器是否在運行
  • "處理錯誤"：檢查 API 服務器日誌以獲取詳細信息

💡 使用建議

任何問題/討論/貢獻都受到歡迎！