Tripo3D 模型,在 Blender 中完成
Tripo3D 可將圖片或提示轉換為帶紋理的網格,約需一分鐘。 每次運行都會消耗點數,其控制項較為粗略,且新的模型版本 對相同提示會產生不同的網格。Blender 是免費且精確的工具,腳本 每次都能給出相同的結果。因此,從 Tripo3D 取得基礎網格一次, 保留它,然後在 Blender 中進行所有精修。僅在形狀錯誤時才為新的運行付費。 尺寸、朝向、凹凸不平的手部、紋理色調以及三角形預算都是 Blender 可修正的。
已於 2026-11-20 在 macOS 上使用 tripo-cli 0.11.2、Blender 5.3.0 和 Node 24 測試。
若 tripo --version 顯示較新版本,請優先參考
tripo docs --topic commands/make 中的標誌說明,而非此檔案。
參考檔案
此檔案引導模型從設定到完成的 GLB 輸出。僅在任務需要其細節時才開啟參考檔案。
| 參考檔案 | 開啟時機 | 行數 |
|---|---|---|
| 設定 | 安裝或登入時、新增 MCP 伺服器時、在 Linux 上工作時,或考慮使用其他 Tripo 路線時 | 146 |
| 圖片 | 為必須符合目標圖片的模型製作輸入圖片,並請人審查時 | 123 |
| 生成 | 選擇模型或參數時、使用多張圖片時、串連 Tripo 自身步驟時,或計算點數時 | 146 |
| Blender | 修正生成的模型時、在即時 Blender 中工作時,或將這些步驟整合到專案建置時 | 283 |
| 錯誤 | 解讀失敗指令的退出碼,或 Blender 腳本錯誤時 | 43 |
此檔案運行的兩個腳本位於其目錄下的 tools/ 中。以下 <skill-dir>
代表包含此 SKILL.md 的資料夾。
1. 人類必須先做的事
這些步驟無法由代理程式完成。請在執行任何操作前要求完成它們。
-
一個付費的 Tripo3D API 帳戶,網址為 https://developers.tripo3d.ai (國際)或 https://developers.tripo3d.com(中國大陸)。API 點數與 Tripo Studio 點數是分開的。付費關乎權利: Tripo 的條款賦予付費使用者其輸出的權利,包括發布和 銷售(第 5.2.2 節),並保留免費使用者的輸出給 Tripo (第 5.2.1 節)。
-
將 API 金鑰存放在系統的安全儲存庫中。 在 macOS 上,人類執行以下指令 並在提示時輸入金鑰,如此金鑰永遠不會通過聊天傳遞:
security add-generic-password -a "$USER" -s tripo3d-api-key -w若無金鑰,設定中的瀏覽器登入方式 也可行。
-
Blender 5.x,且
blender在路徑中。即時控制還需要 Blender Lab MCP 外掛程式,並啟用允許線上存取;詳見 Blender。
絕對不要在聊天中詢問金鑰,也不要將它寫入你建立的任何檔案中。請像第 2 節一樣, 直接從安全儲存庫中讀取金鑰。
2. 設定 Tripo3D
每台機器執行一次:
node --version # 需要 20 或更高版本
npm install -g tripo-cli # 安裝 `tripo` 指令
tripo login --key "$(security find-generic-password -s tripo3d-api-key -w)" \
2>&1 | sed -E 's/tsk_[A-Za-z0-9_-]+/tsk_<hidden>/g'
tripo doctor # 每個檢查都應為 "ok": true
tripo login --key 會嘗試兩個區域,保留接受該金鑰的區域,並
將其儲存在 ~/.tripo/config.json 中,權限設為 0600,因此後續指令
無需再提供金鑰。tripo doctor 中餘額為零是警告,並非失敗。
所有 Tripo 呼叫請使用 Tripo 的官方工具 tripo-cli。較舊的
Tripo-Developer/tripo-mcp 伺服器啟動時會崩潰,並驅動一個
已不存在的 Blender 外掛程式。Blender 中的 Tripo Bridge 外掛程式
僅接受從 Tripo 網站傳送的模型。
設定中有詳細說明。
3. 生成基礎模型
選擇輸入。 一張整個物體的圖片,需獨自呈現、背景單純,
並採用正面或三分之三視角。兩到四張圖片能涵蓋隱藏的面;
將檔案命名為 front、left、back 和 right。模型
會複製圖片的形狀、表面和顏色,因此磨損、苔蘚和顏色都必須
呈現在圖片中。使用引號括起提示詞也可行,但控制程度較低。
在付款前請先審查圖片。 圖片中的缺陷會反映在網格中, 而重新運行又會消耗點數。當人類提供目標(例如概念圖或照片) 並希望模型與之匹配時:
- 僅根據目標撰寫一份檢查清單:每個部分顯示的內容、失敗處、 以及可測量的比例和顏色;
- 為每個視角製作 2 到 8 個新的候選圖片,先製作正面, 然後根據通過的正面製作其他視角;
- 將目標、檢查清單和候選圖片交給一個獨立的審查者, 可以是另一個代理程式或未參與製作的人員,其任務是找出不合格處;
- 僅對通過的圖片執行 Tripo3D,並記錄審查者放行的要點, 以供後續的 Blender 精修參考。
圖片包含完整的循環流程、如何向審查者簡報、 圖片不合格的情況以及如何測量圖片。
選擇模型。 若未指定 --model,每次運行將使用 P2,
其成本約為 H3.1 的三倍。
| 模型 | 標誌 | 乾運行預估 | 適用場景 |
|---|---|---|---|
| H3.1 | --model tripo-v3.1 | 10 到 50 點;帶有詳細 PBR 貼圖的圖片為 40 點 | 詳細的實心物體:雕像、道具、岩石 |
| P2 (預設) | --model tripo-p2 | 100 到 130 點;普通圖片為 110 點 | 乾淨的低多邊形拓撲結構,四邊面 |
進行乾運行。 乾運行不會發送任何內容,也不會消耗任何點數:
tripo make ref.png --model tripo-v3.1 --seed 7 \
-p face_limit=30000 -p pbr=true -p texture_quality=detailed \
-p texture_version=v3.5-20260815 -p delight=true \
--name statue -o tripo-out/statue --dry-run --json
valid 必須為 true,errors 必須為空。warnings 中的每個條目
都是 CLI 移除的設定,代表該需求將不會被滿足;請在付費前處理它。
generation_credits_estimate 是單獨生成的標價。
執行實際運行,不帶 --dry-run。指令會阻塞,直到模型、
preview.png 和 task.json 出現在 -o 資料夾中,然後列印一行
JSON。請從其 model_file 欄位取得模型的路徑,因為檔案名稱
會隨選項而變化(例如 pbr_model.glb)。請先查看 preview.png
再繼續。
保留原始結果。 下載連結約五分鐘後過期, 而且後續的模型版本會從相同的種子產生另一個網格, 因此下載的檔案是唯一的副本:
mkdir -p assets/raw/statue
cp tripo-out/statue/* assets/raw/statue/ # 模型、task.json、preview.png
提交該資料夾,或將其與專案的原始資產放在一起。每個 Blender 步驟都會讀取此副本,絕不透過網路,因此重新建置會得到相同的檔案。
停下來詢問人類:
- 在預計消耗超過 50 點數的任何運行、任何 P2 運行,以及預計總和超過 150 點數的任何批次之前;
- 在退出碼為 4(點數不足)之後,因為每次重試都會以相同方式失敗:請告知人類執行
tripo topup並等待; - 在執行
tripo redo之前,因為這是一次新的付費運行,使用新的種子且沒有乾運行。
4. 在 Blender 中完成
兩個腳本均以無視窗模式執行,且從不使用網路。
找出正面。 Tripo 的文件指出 +x 是生成模型的前方軸向。
Blender 的前視圖沿著 +y 方向觀察,並顯示面向 -y 的那一側,因此
將 +x 轉為 -y 需要 --turn -90。並非所有網格都遵循預設值,因此
請先渲染原始模型並查看 front.png:
blender --background --factory-startup \
--python <skill-dir>/tools/preview_model.py -- \
assets/raw/statue/<model>.glb build/statue-raw --size 640
它會在大約兩秒內寫入 front.png、side.png 和 top.png。
完成它:
blender --background --factory-startup \
--python <skill-dir>/tools/finish_model.py -- \
assets/raw/statue/<model>.glb build/statue.glb \
--height 6.5 --name statue --turn -90 --levels 0.4,0.12 --texture 1024
該腳本會將所有變換烘焙到頂點中,將各部分合併為一個物體,
並合併重複的頂點。它會將模型繞垂直軸旋轉 --turn 度,
縮放至 --height 公尺,居中放置,並使其最低點立足於地面。
然後,它會縮短長度超過 --texture 紋素的紋理,並寫入 statue.glb,
以及三角形數量分別減少至 40% 和 12% 的 statue-1.glb 和
statue-2.glb。其最後一行 FINISHED {...} 會給出尺寸、
縮小的紋理,以及每個檔案的三角形數量和位元組大小。
只有 --height 是必需的。--turn 預設為 0,若未指定
--levels 或 --texture,則不會製作副本並保留紋理。
以相同方式渲染完成後的檔案並再次檢視。如果朝向錯誤,請變更
--turn 並從原始檔案重新完成。切勿旋轉已匯出的檔案。
在付款進行新運行前,先在 Blender 中修正。 比例、朝向、樞軸點、 三角形數量、紋理大小、顏色、小凸起和孔洞,以及合併的零件 都是 Blender 的工作。僅在形狀本身錯誤時才返回 Tripo3D。 Blender中有對照表。
使用即時 Blender 進行嘗試, 例如雕刻手部或比較視角。 每個最終發布的變更都應寫入可從原始檔案重建模型的腳本中, 因為手動編輯無法重複或審查,且下一次重新生成會遺失它。 如果專案已使用 Blender 腳本建置其模型,請將這些步驟加入該建置流程, 而非直接交付此腳本的輸出。