Community影像github.com

tripo3d-blender

影像技能。使用 Tripo3D 生成 3D 模型並在 Blender 中完成精修。Tripo3D 根據提示或圖片產生基礎網格,而所有細緻調整——如尺寸、朝向、樞軸、清理、雕刻修復、重新上色、紋理大小、細節層級與 GLB 匯出——都在 Blender 中完成,無論是無頭模式還是即時操作。適用於從文字或圖片生成 3D 模型、雕像、道具、建築、岩石、角色或遊戲資產,或需要符合概念圖或照片的場景。

tripo3d-blender 是什麼?

這是一個專門用於 3D 建模的技能,結合了 Tripo3D 的快速生成能力與 Blender 的細緻控制能力。Tripo3D 可在一分鐘內將圖片或文字提示轉換為帶紋理的網格,每次生成會消耗點數且控制項較為粗略;而 Blender 是免費且精確的工具,透過腳本可確保每次輸出的一致性。此技能的工作流程是:先用 Tripo3D 獲取基礎網格(付費一次),然後在 Blender 中進行所有精修——包括調整尺寸、朝向、樞軸點、清理網格、修復凸起或凹陷、重新上色、設定紋理大小、產生多層細節(LOD)以及最終的 GLB 匯出。僅在形狀從根本上錯誤時才需要返回到 Tripo3D 重新生成。支援 macOS 平台,並與三種主要工作模式相容:純腳本自動化(Blender 無頭模式)、即時 Blender(透過 Blender Lab MCP 外掛程式進行互動式調整),以及整合至專案建置流程中。它的獨特優勢在於將成本高昂的 AI 生成限制在形狀創建這一關鍵步驟,而將所有可重複的調整工作交由免費且開源的 Blender 完成,從而大幅節省 API 點數。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hiddentao/tripo3d-blender-skill/tree/HEAD/tripo3d-blender

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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. 人類必須先做的事

這些步驟無法由代理程式完成。請在執行任何操作前要求完成它們。

  1. 一個付費的 Tripo3D API 帳戶,網址為 https://developers.tripo3d.ai (國際)或 https://developers.tripo3d.com(中國大陸)。API 點數與 Tripo Studio 點數是分開的。付費關乎權利: Tripo 的條款賦予付費使用者其輸出的權利,包括發布和 銷售(第 5.2.2 節),並保留免費使用者的輸出給 Tripo (第 5.2.1 節)。

  2. 將 API 金鑰存放在系統的安全儲存庫中。 在 macOS 上,人類執行以下指令 並在提示時輸入金鑰,如此金鑰永遠不會通過聊天傳遞:

    security add-generic-password -a "$USER" -s tripo3d-api-key -w
    

    若無金鑰,設定中的瀏覽器登入方式 也可行。

  3. 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。模型 會複製圖片的形狀、表面和顏色,因此磨損、苔蘚和顏色都必須 呈現在圖片中。使用引號括起提示詞也可行,但控制程度較低。

在付款前請先審查圖片。 圖片中的缺陷會反映在網格中, 而重新運行又會消耗點數。當人類提供目標(例如概念圖或照片) 並希望模型與之匹配時:

  1. 僅根據目標撰寫一份檢查清單:每個部分顯示的內容、失敗處、 以及可測量的比例和顏色;
  2. 為每個視角製作 2 到 8 個新的候選圖片,先製作正面, 然後根據通過的正面製作其他視角;
  3. 將目標、檢查清單和候選圖片交給一個獨立的審查者, 可以是另一個代理程式或未參與製作的人員,其任務是找出不合格處;
  4. 僅對通過的圖片執行 Tripo3D,並記錄審查者放行的要點, 以供後續的 Blender 精修參考。

圖片包含完整的循環流程、如何向審查者簡報、 圖片不合格的情況以及如何測量圖片。

選擇模型。 若未指定 --model,每次運行將使用 P2, 其成本約為 H3.1 的三倍。

模型標誌乾運行預估適用場景
H3.1--model tripo-v3.110 到 50 點;帶有詳細 PBR 貼圖的圖片為 40 點詳細的實心物體:雕像、道具、岩石
P2 (預設)--model tripo-p2100 到 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 腳本建置其模型,請將這些步驟加入該建置流程, 而非直接交付此腳本的輸出。

相關技能