Hunyuan3D 2.1 傳回 GLB 後,仍要確認紋理階段是否失敗

Hunyuan3D 2.1 的官方工作程序會在紋理生成失敗時,回退至沒有紋理的網格。將形狀、紋理與目標場景匯入分開驗收,才能避免把「有檔案」誤當成可交付的資產。

來源: github.com
November 11, 2026
1 min

團隊要將一張參考圖轉成可放入展示場景的靜態道具時,Tencent Hunyuan 3D 可以負責初始網格與紋理生成。但整合進流程時,完成標準應以目標場景中的實際資產為準,而不是下載到一個 GLB 檔案。本文以官方開源 Hunyuan3D 2.1 的程式碼為依據設計驗收流程,未執行生成測試,也不將這個版本的行為套用到所有託管服務。

官方 model_worker.py 中有一個容易忽略的分支:它會先匯出沒有紋理的網格,再嘗試生成紋理和轉換格式;若紋理步驟拋出例外,就會將最初沒有紋理的網格路徑作為最終路徑傳回。因此,下游即使取得了檔案,也可能沒有得到預期的帶紋理成品。整合自動化時,應儲存任務記錄與各階段結果,分別記錄「幾何生成成功」和「紋理生成成功」。

先檢查形狀,再投入紋理處理

以製作展示用桌面擺飾為例,先準備有權使用的參考圖,並寫下必須保留的輪廓特徵。官方 demo.py 展示了兩階段流程:形狀管線生成網格並匯出 demo.glb,接著紋理管線接收網格路徑和參考圖,輸出 demo_textured.glb。它提供了可分開檢查的節點,但範例本身不能證明資產適合你的場景。

建議先以無紋理檢視旋轉模型,查看正面、側面和背面,檢查輪廓、薄片與底部。參考圖沒有呈現的部位,尤其需要人工判斷。若形狀不符合要求,應回到參考素材或模型修整環節,不要期待加上紋理就能修正結構。只有形狀通過後,才繼續處理材質,並分別保留兩個階段的檔案,方便找出需要重做的原因。

在本機執行前,也要核對資源。儲存庫 README 列出的顯示記憶體需求為形狀生成 10GB、紋理生成 21GB,完整流程 29GB(官方列示);這是官方的環境說明,不是本文測得的峰值。只有形狀步驟能執行,不代表完整流程也能執行。應請負責部署的人先依使用版本和實際硬體驗證整條流程,再承諾批次產能。

交接時驗證場景,不只驗證檔案

紋理階段結束後,開啟結果並確認材質確實存在;若記錄顯示發生回退,應將任務標記為待補紋理,而不是交付完成。接著將資產匯入實際使用的編輯器或引擎,在目標光照下檢查外觀、比例和朝向,並請接收者確認是否還需要減面、碰撞體或其他加工。這些是建議的交付檢查,不是程式碼會自動完成的驗收。

對需要快速取得靜態道具初稿的團隊來說,這種分階段流程能讓失敗停在正確的位置。若需求是直接交付可綁定動畫的角色、尺寸精確的零件,或符合既有拓撲規範的模型,僅憑生成檔案不能確認達標,應保留專門的建模與技術驗收環節。正式使用前,也應核對所用模型版本的授權條款與參考素材權利。先讓一個資產完整走過生成、檢查、匯入與接收流程,再決定是否擴大成批次任務。

內容說明:本文基於公開資料整理,僅供工具選型參考。產品功能、價格及相關政策可能隨時調整,請以官方最新資訊為準。

原文出處:github.com