MeshifAI

MeshifAI 是什麼

MeshifAI 是一個為開發者及 3D 內容創作者所設計的文本生成 3D 平台。使用者可以用自然語言來描述物體，系統則會回傳可下載的 GLB 模型。它適用於遊戲、WebGL、AR/VR、教育領域以及快速原型開發，但並非用於生成通用程式碼的工具。

該產品提供 JavaScript SDK 與 Unity 工作流程，既可在應用程式代碼中觸發資產的生成，也可在 Unity 編輯器內輸入提示、預覽並儲存資產。本文件主要介紹簡單模型的生成方式，而進行專業級的製作時，可能仍需要在 Blender、Unity 或 Unreal 中對資產進行整理與優化。

主要功能

• 文本生成 3D：輸入物體、角色或環境的英文描述，服務會生成對應的三維網格。說明應包含主體、形狀、風格、比例及關鍵細節，並避免出現相互衝突的要求。
• 無紋理模型：預設路徑的生成速度更快、穩定性也更高，適合用來驗證輪廓、體積以及場景的結構。之後可以在專業工具中加入材質、UV、貼圖和動畫等元素。
• 紋理模型：可請求帶有 PBR 材質的模型，視覺完成度更高，但文件中明確標示為高度實驗性，生成時間更長且可靠性較低。
• 創意變化控制：SDK 提供 variance 等選項，用來調節不同生成結果之間的變化程度。較高的變化程度適合用於探索，而當需要精確一致的結果時，則應降低變化程度，並保存可重複的輸入資料。
• GLB輸出：目前生成的結果採用GL Transmission Format Binary格式，可在Blender、Unity、Unreal、網頁檢視器以及大多數AR/VR工作流程中使用。
• JavaScript SDK：應用程式透過 textTo3d 方法來傳送提示與參數，並以非同步方式取得模型地址。開發者必須處理超時、失敗、無效的回傳結果，以及地址過期等狀況。
• Unity 編輯器工具：從 Unity 的視窗選單中開啟 Text-To-3D，輸入提示語後即可生成並預覽模型，若滿意則可將其儲存到專案資產目錄中。
• Unity 脚本介面：運行時可呼叫生成方法，設定成功、錯誤和進度回呼，並讀取提示、變化值和生成時間等元資料。
• 網頁相容性：GLB 可直接用於 WebGL 與瀏覽器的三維檢視器，適合用於產品展示、互動原型以及輕量級遊戲。不過，模型的面數、紋理尺寸以及載入時間仍需開發者進一步優化。

輸入、輸出與檔案

JavaScript 接入流程

1. 確認專案使用受支援的 JavaScript 或 TypeScript 工具鏈，並從 npm 安裝 MeshifAI 套件。
2. 在伺服器或受控運行環境中導入 SDK，不要把未確認安全範圍的金鑰和呼叫邏輯直接暴露給訪客。
3. 先調用 textTo3d 生成無紋理模型，使用簡短而明確的物體描述驗證流程。
4. 讀取返回的模型地址，下載或載入 GLB，並為網路失敗、超時和空結果設定錯誤處理。
5. 根據需要調整 variance 等參數，記錄提示、參數、SDK 版本和生成時間。
6. 只有在無紋理流程穩定之後，再嘗試 textured 選項，並為更長的生成時間與失敗準備重試策略。
7. 把模型放入網頁三維查看器或後續資產流水線，檢查網格、比例、材質、UV、面數和載入性能。

Unity 編輯器使用流程

1. 依照 Unity 安裝說明書來導入相關工具，然後在專案中開啟 MeshifAI 的 Text-To-3D 視窗。
2. 輸入需要的模型描述並點擊生成，等待狀態完成後在編輯器中預覽。
3. 旋轉、縮放並查看網格形狀，不滿意時修改提示重新生成，無需保存每次結果。
4. 確認後保存，工具會把 GLB 放到 GeneratedModels 對應模型目錄。
5. 將資產拖入場景，設定比例、材質、碰撞體、光照、LOD 以及靜態或動態標記。
6. 運行遊戲性能測試，並在發布前檢查模型授權、品牌元素與不適當內容。

Unity 脚本接入

• 使用 GenerateModel 類方法提交提示，並註冊成功回呼將返回的 GameObject 加入場景。
• 為錯誤回呼顯示可理解的失敗資訊，不要讓網路異常阻擋遊戲主執行緒或無限重試。
• 使用狀態回呼更新進度條，但不要把估計進度當成嚴格完成時間。
• 讀取 ModelGenerationData 中的提示、變化值和生成時間，便於調試與審計使用者生成的內容。
• 如果允許最終用戶輸入提示，應增加內容過濾、速率限制、成本控制、快取以及人工舉報機制。

適合用戶與場景

• 獨立遊戲開發者：快速生成道具、簡單環境物件和佔位模型，加快玩法原型。
• 網頁開發者：在產品展示、教育頁面和互動體驗中動態載入 GLB。
• AR/VR 團隊：用文字快速探索空間物件，再交給專業美術優化。
• 教師與學生：為概念講解、專案示範和三維編程課程製作簡單資產。
• 產品與創意團隊：在進行建模之前，先驗證形狀、構圖和場景方向。
• 不適合直接生成需要嚴格尺寸、公差、工程認證、醫學精度或 AAA 級拓撲的最終資產。

平台與組件

價格與用量

尚未確認標準訂閱價格、免費額度、積分扣減、併發限制、超額費用、企業方案或退款規則。即使 SDK 可以免費安裝，模型生成仍依賴遠端服務，部署前必須確認帳戶、金鑰、用量與商業條款。

SDK、GitHub 與開源狀態

在 npm 上，JavaScript 套件是由與文件說明中所述的發布者所提供，而套件的元資料則顯示出 MIT 授權條款。此授權條款適用於 SDK 套件的程式碼，允許使用者根據授權條款來使用、修改及散布該程式碼，但此授權並不涵蓋雲端模型、生成服務、網站、Unity 組件或各種生成的資產。

目前還沒有找到包含完整產品資料的官方 GitHub 儲存庫，也沒有能夠說明所有組件相關條款的統一許可證文件。開發者應在安裝的版本中保留 MIT 授权條款，並分別確認 Unity 工具、相關依賴項目以及伺服器端的相關條款。

隱私、安全、版權與商用

• 沒有確認到公開的隱私政策、服務條款、安全說明、分包商清單、資料位置、保留期限或刪除流程。
• 文本提示會發送到遠端生成服務，返回的模型地址也可能由雲端託管。請勿提交客戶機密、未公開的角色設計、個人資訊或無法被外傳的項目資料。
• 公開文件未說明提示或生成模型是否用於訓練，也未披露模型供應商。商業團隊應在使用前獲得資料處理與訓練政策的確認。
• 文件將輸出描述為適合商業應用，但未找到完整生成資產授權、排他性、相似內容、商標與侵權處理條款。正式發布前應取得明確的商用許可。
• 生成模型可能與現有角色、品牌、產品或受保護設計相似，用戶需進行版權、商標、外觀和內容審核。
• 運行時生成會引入成本、延遲、失敗及不當內容風險，應在伺服器側限制調用、記錄審計並提供人工處置。

優勢與使用限制

• 優勢：文本到 GLB 的路徑直接，輸出能進入網頁、Blender、Unity、Unreal 以及 AR/VR 工具鏈。
• 優勢：同時提供 JavaScript 與 Unity 入口，便於網頁和遊戲開發者接入。
• 優勢：Unity 編輯器支援生成前後預覽，不滿意時可直接重試，而不會損害專案資產。
• 限制：紋理模型仍屬高度實驗性，生成速度與穩定性低於無紋理模式。
• 限制：公開文件沒有網格品質、面數、拓撲、UV、骨骼、動畫和基準數據的保證。
• 限制：價格、額度、API SLA、隱私、商用及退款資料不足，不宜直接作為關鍵生產依賴。
• 限制：AI 生成模型通常需要人工調整比例、碰撞、拓撲、材質和性能。

總結

MeshifAI 適合那些需要從文字快速獲得 GLB 原型的 JavaScript 與 Unity 開發者，尤其適用於遊戲、WebGL 以及 AR/VR 的早期驗證。在正式上線之前，應先測試無紋理的處理流程，再評估實驗性紋理輸出的效果，同時也要考慮價格、服務穩定性、資料處理方式以及商業授權等問題。