Hunyuan3d 2 0

一句話介紹

Hunyuan3D 2.0是騰訊混元團隊發布的3D資產生成模型，可先從圖片或文字條件生成幾何網格，再為網格合成高解析度紋理。

工具簡介

Hunyuan3D 2.0由Hunyuan3D-DiT幾何模型和Hunyuan3D-Paint紋理模型組成。幾何與紋理解耦後，使用者既能生成完整帶紋理的模型，也能只生成白模，或為已有網格重新繪製紋理。

該版本在2025年1月發布，代碼和模型權重可用於本地部署。腾讯後續已經發布2.1、2.5以及雲端3.0、3.1等版本，因此2.0應理解為一個仍可使用的歷史版本，而不是當前最高版本。

兩階段生成架構

分階段設計讓使用者只能執行所需的部份。當已有人工建模的網格時，可以跳過幾何體的生成，直接使用紋理處理流程。

主要功能

單圖生成3D幾何

用戶提供主體清晰的參考圖後，幾何模型會推斷不可見視角並生成網格。結果可作為概念模型、打印前的原型，或後續人工建模的起點。

多視圖生成

Hunyuan3D-2mv系列能夠接收多個視角，進而提升幾何約束以及不同方向之間的一致性。輸入的圖片需保持相同的對象、相近的比例以及一致的外觀，否則可能會出現結構衝突。

文生3D

本地API服務包含文字轉3D的調用路徑，在線服務也提供文生3D功能。文字描述更適合用於概念探索，而若要精確複製產品，則通常應使用單張圖片或多視圖輸入。

高解析度紋理生成

Hunyuan3D-Paint運用網格與參考圖來生成紋理貼圖，可用於模型生成後的上色，亦可處理人工製作的網格。紋理品質仍受UV、網格拓撲、參考圖的清晰度以及遮擋效應的影響。

快速與輕量版本

該專案提供 Fast、Turbo、Mini 和多視圖等不同版本，讓用戶能在速度、顯存、幾何容量以及輸入方式之間做出不同的取捨。輕量級或經過優化處理的版本適合用於快速迭代，但最終的成果仍需透過實際任務來測試。

模型導出

Python管線會傳回可進一步處理的三維網格物件，且可儲存為GLB、OBJ等格式。在將其用於遊戲、影視、列印或電子商務等領域之前，通常還需要檢查面數、法線、UV座標、材質以及單位等資訊。

本地Gradio介面

倉庫附帶 Gradio 應用，使用者可透過本機的圖形介面來選擇模型、上傳參考圖，並以此生成資產。它適合用於試用及內部原型開發，但若要作為正式的服務使用，則仍需加入權限控制、排隊機制、監控功能以及資源隔離措施。

本地API服務

官方範例可以啟動本機API服務，用於處理圖像轉換為3D、文字轉換為3D，以及生成現有的網格紋理。開發者可將模型整合到內部工具中，但必須自行實作認證、限流、任務狀態追蹤以及檔案清理等功能。

Blender插件

該專案提供了Blender插件，可在啟動本地API服務後，從Blender內直接調用相關功能來生成模型。此插件縮短了模型生成與後續編輯之間的步驟，但無法自動完成遊戲級別的拓撲結構及動畫設定。

模型版本對比

2.0與後續版本的關係

版本名稱相近，但許可證、介面、價格和部署方式並不相同。2.0倉庫的社群許可證不能自動代表後續模型或騰訊雲商業API條款。

本地部署要求

該專案支援macOS、Windows和Linux，但紋理模組包含自訂的柵格化與可微渲染組件，實際的相容性則取決於顯卡、驅動程式、PyTorch以及編譯環境。根據官方的說明，產生幾何圖形大約需要6GB的顯存，而完成幾何圖形與紋理的處理過程則大約需要16GB的顯存。

安裝前準備

• 確認作業系統、NVIDIA驅動程式、CUDA和PyTorch版本相互相容。
• 為模型權重、緩存、中間網格和紋理檔案預留足夠的磁盤空間。
• 紋理生成需要編譯自訂的柵格化與可微渲染組件。
• Windows或非標準顯卡環境可能需要額外編譯與依賴排錯。
• 生產部署應使用獨立環境鎖定依賴版本，並保存可重現的建構記錄。

本地使用教學

安裝並生成第一個模型

1. 檢查顯卡顯存和驅動，建立獨立Python虛擬環境。
2. 安裝與硬體相容的PyTorch，再安裝專案依賴和Hunyuan3D套件。
3. 需要紋理時，編譯自訂柵格化器與可微渲染組件。
4. 下載對應的Hunyuan3D-DiT和Paint模型權重。
5. 準備主體居中、背景簡潔且解析度足夠的參考圖片。
6. 先運行幾何管線生成白模，並檢查輪廓和缺失視角。
7. 需要成品外觀時再運行紋理管線，並導出GLB或OBJ。
8. 在Blender或其他DCC工具中檢查法線、拓撲、UV、材質和比例。

部署本地API

1. 先用最小示例確認幾何和紋理管線能夠在當前設備運行。
2. 啟動專案附帶的API服務，並僅監聽受信任的網路介面。
3. 為請求增加身份驗證、檔案大小限制和任務超時。
4. 將長時間生成的設計為異步隊列，避免請求連接持續佔用。
5. 對上傳圖片、網格和輸出資產設定隔離目錄與自動清理期限。
6. 記錄模型版本、隨機種子和參數，便於問題重現。
7. 上線前執行並發、顯存溢出、異常檔案和磁盤耗盡測試。

輸入圖片建議

• 優先選擇主體完整、居中、邊緣清晰且背景乾淨的圖片。
• 避免嚴重遮擋、鏡面反射、透明材質和複雜運動模糊。
• 產品復刻應提供正面、側面和背面等一致多視圖。
• 不同視圖的顏色、比例和細節不能相互矛盾。
• 參考圖中的強陰影可能被誤當作紋理，應考慮進行光線預處理。
• 單圖無法提供隱藏結構，生成結果必須由人工檢查背面和底部。

輸出模型後處理

• 刪除懸浮幾何、自交面、孔洞和不可見內部結構。
• 檢查面朝向、法線平滑和模型軸向是否符合目標引擎。
• 根據實時渲染、列印或影視用途重新拓撲和控制面數。
• 檢查UV接縫、紋理拉伸、材質通道和色彩空間。
• 3D列印前確認模型封閉、壁厚、比例和支撐結構。
• 在綁定骨骼或製作動畫之前，需要建立適合變形的拓撲結構。
• 商用前檢查輸入圖片、品牌、人物和生成資產的權利。

當前騰訊雲API能力

目前，騰訊雲混元生3D已不再以2.0作為最高版本。專業版則可使用3.0和3.1版本，並提供文生3D、圖生3D、多視圖、白模、草圖以及智能拓撲生成等功能。

腾讯雲文件同時提示，原混元大模型平台正在將新增能力遷移至TokenHub。已有服務可以繼續使用，但新購能力及後續模型應到目前控制台核對。

騰訊雲價格與積分包

截至2026年8月23日，中國站採用通用積分計費方式。新用戶開通帳號後可獲得一次性的100積分體驗包，免費額度的有效期為一年，實際的扣分數則取決於所選用的生成及後處理能力。

積分與退款規則

• 免費積分、預付費積分和後付費則依相應結算順序扣減。
• 預付費積分包自購買日起一年有效，過期未用部分失效。
• 資源包使用後不支援凍結剩餘積分。
• 購買後未使用的資源包支持七天內無理由退款。
• 免費或預付費餘額耗盡後不會預設自動進入後付費，需要主動開通。
• 單次任務的積分消耗取決於模型版本、生成類型和後處理能力。
• 併發疊加包價格較高，批量業務應先驗證預設併發與隊列方案。

雲API與本地部署成本對比

開源狀態與許可證

Hunyuan3D 2.0公開了推理代碼和預訓練模型，但使用的是騰訊混元3D 2.0社區許可證，而非MIT、Apache-2.0或其他通用開源許可證。目錄中更準確的標記是「代碼與權重公開，受定制社區許可證限制」。

地域限制

2.0社區許可證的適用地區明確排除了歐盟、英國和韓國。在這些地區使用、複製、修改、散發或展示模型及輸出成果，均不屬於該許可證的授權範圍。

大規模商業使用

如果被許可方所有產品或服務在2.0發布日期前一個月的月活用戶總數超過100萬，需要向騰訊申請額外許可。是否收費及能否批准由騰訊另行決定。

分发義務

在分發模型或衍生作品時，需向接收方提供許可證、標註修改過的檔案，並隨非託管服務一同分發附有說明文的文件。在向第三方提供服務時，也應揭露實際的服務提供主體，以避免造成人們認為該服務是由騰訊贊助或背書的誤解。

模型訓練限制

許可證禁止使用Hunyuan3D 2.0的作品或其輸出來的內容來改進其他AI模型，但Hunyuan3D 2.0本身及其衍生版本則不在限制範圍內。若打算利用這些生成的資產來建立其他模型的訓練集，則必須進行特別審查。

輸出權利

許可證表示騰訊不主張用戶生成輸出的權利，但用戶對輸出及後續使用自行負責。該說明不能消除輸入圖片的版權、商標、人物權利或第三方素材風險。

適合哪些用戶

• 研究圖生3D、幾何擴散和紋理生成的開發者。
• 希望能在本地GPU上構建3D資產生成原型的技術團隊。
• 需要把3D生成接入Blender或內部工作流的內容團隊。
• 製作遊戲道具、影視概念、電商展示及3D列印原型的創作者。
• 希望比較Mini、Fast、Turbo和多視圖版本的研究人員。
• 不想維護GPU服務並計劃使用目前騰訊雲3D API的企業。

產品優勢

• 幾何與紋理分開生成，便於替換或單獨使用不同階段。
• 支援單圖、多視圖、文字條件及既有網格紋理生成。
• 提供Python管線、Gradio介面、本地API和Blender插件。
• 可導出常見3D格式，並接入主流DCC與引擎流程。
• 模型系列覆蓋標準、輕量、快速和多視圖需求。
• 本地部署時不按生成次數向模型項目支付費用。
• 後續2.1及雲端3.x為不同品質和服務需求提供升級路徑。

使用限制與注意事項

• 單圖無法真實還原不可見部分，複雜背面和內部結構容易出錯。
• 生成網格不等同於遊戲或動畫成品，常需要清理、重拓撲和重新UV。
• 透明、反光、細線、毛髮以及複雜的空洞結構仍可能產生不穩定。
• 完整紋理管線約需16GB顯存，並包含需要編譯的組件。
• 不同系統和顯卡組合可能遇到驅動、CUDA或柵格化器相容問題。
• 社區許可證存在地域、月活用戶和模型訓練限制。
• 騰訊雲目前的模型與2.0本地模型並非同一服務，價格和條款不能混用。
• 任何生成結果在進入商用、列印或安全關鍵流程前都應人工驗證。

基本資訊

常見問題

Hunyuan3D 2.0是什麼？

它是騰訊混元團隊發布的高解析度3D資產生成系統，透過幾何模型先生成網格，再由紋理模型完成上色。

可以免費使用嗎？

本地代碼和權重不會根據呼叫次數收取費用，但必須遵守社群許可證的規定，且需自行承擔GPU、儲存及運維的費用。而腾讯雲的商業API則提供免費體驗積分、預付費積分包或後付費的方式。

需要多少顯存？

官方模型表給出的參考值是，僅進行幾何處理時約需6GB，而完成幾何處理與紋理處理之後則約需16GB。實際佔用量會隨著模型版本、解析度、精確度以及同時處理的任務數量而改變。

支援Windows嗎？

項目列出了Windows、macOS和Linux的支援情況。紋理組件需要在本地上編譯，而在Windows環境中，仍可能因編譯工具、驅動程式以及CUDA的組合而產生額外的問題。

能導入Blender嗎？

可以導出GLB、OBJ等檔案，也提供與本地API配合使用的Blender插件。導入後仍應檢查坐標、比例、材質、法線和拓撲。

能生成可直接用於遊戲的模型嗎？

通常無法保證能直接達到生產標準。生成的結果往往還需要減少面數、重拓撲、修復法線、重新UV貼圖、整理材質，並驗證引擎性能。

Hunyuan3D 2.0是完全開源嗎？

代碼和權重是公開的，但需使用自訂的社群許可證，且存在地域、規模、發行和訓練方面的限制。因此，不應簡單地將其歸類為MIT或Apache類型的開源軟體。

目前騰訊雲還是2.0嗎？

目前，專業版已提供 3.0 和 3.1 版本，此外還有極速版，以及用於後處理的拓撲、紋理、組件和 UV 等功能。2.0 版則主要作為可本地部署的歷史版本而存在。

腾讯雲積分包會過期嗎？

會。目前預付費積分包自購買日起一年有效，未使用部分到期失效；已使用的資源包不能凍結剩餘積分。

可以用生成結果訓練其他模型嗎？

2.0社區許可證禁止使用模型作品或其輸出結果來改進其他AI模型，Hunyuan3D 2.0及其模型衍生版本除外。在進行訓練之前，應由法務人員根據實際用途進行審查。

總結

Hunyuan3D 2.0適合那些希望進行本地研究，或希望將圖像轉換為3D模型、進行幾何形狀的生成以及紋理合成的開發者。其兩階段架構、多種模型變體、本地API以及Blender插件，都為開發者提供了相當完整的技術基礎。

採用前應同時評估硬體、後處理工作量與社區許可證限制。若更看重最新模型、無需自建GPU及企業API支持，應比較目前腾讯雲3.0、3.1與極速版，並按實時積分規則核算成本。