# ComfyUI ノード ComfyUI-Tripo は、Tripo 公式の ComfyUI 向けカスタムノード拡張です。テキスト、画像、マルチビュー画像からの 3D 生成を ComfyUI ワークフローに統合し、モデルのインポート、テクスチャ生成、精細化、メッシュ処理、ローポリ化、スタイル変換、リギング、アニメーションのリターゲティング、形式変換、リトポロジーにも対応します。 | 項目 | 値 | | --- | --- | | Node プロジェクトバージョン | <code>1.3.0</code> | | ソースタグ | <code>v1.3.1.1</code> | | リポジトリ | [VAST-AI-Research/ComfyUI-Tripo](https://github.com/VAST-AI-Research/ComfyUI-Tripo) | ## 機能と変更履歴 ### 機能 - テキストから 3D モデルを生成します。 - 画像から 3D モデルを生成します。 - <code>model_url</code> を使って URL からモデルをインポートします。 - モデルのパーツ分割に対応します。 - 3D モデルをリグしてアニメーションを適用します。 - 形式変換とリトポロジーを実行します。 ### 変更履歴 - 2026-06-30：モデルのパーツ分割に対応する Mesh Segmentation v2.0 と <code>model_url</code> による URL 直接インポートを追加。 - 2026-05-28：モデルインポートを追加。 - 2025-06-19：最新 API に更新し、ノードを追加。 - 2025-03-31：<code>tripo3d</code> パッケージへ移行。 - 2025-02-24：<code>glbviewer</code> を削除。 - 2025-02-01：新 API に対応し、モデル表示を Preview 3D に変更。 - 2024-11-11：新 API に対応。 - 2024-10-14：モデル変換を追加。 - 2024-09-13：<code>model_version</code> <code>v2.0-20240919</code> に対応。 ## インストール 公式ツール：[ComfyUI-Manager](https://github.com/ltdrdata/ComfyUI-Manager)、[Comfy Registry](https://registry.comfy.org/)、[comfy-cli](https://github.com/Comfy-Org/comfy-cli)。 **いずれかの方法**でインストールし、ComfyUI を再起動します。 1. **ComfyUI-Manager:** Custom Nodes Manager で <code>Tripo for ComfyUI</code> を検索してインストールします。 2. **comfy-cli:** ~~~bash comfy node registry-install comfyui-tripo ~~~ 3. **ソースから:** ~~~bash cd ComfyUI/custom_nodes git clone https://github.com/VAST-AI-Research/ComfyUI-Tripo.git python -m pip install -r ComfyUI-Tripo/requirements.txt ~~~ ## API Key の設定 まず [Tripo プラットフォーム](https://platform.tripo3d.ai/)で API Key を作成し、次のいずれかの方法で設定します。 API Key は次の順序で解決されます。 1. ノードの空でない <code>apikey</code> 入力。 2. 環境変数 <code>TRIPO_API_KEY</code>。 3. プロジェクトディレクトリの <code>config.json</code> にある <code>TRIPO_API_KEY</code> フィールド。 Generate と Import は <code>apikey</code> を持ち、後続ノードは解決済み Key を <code>MODEL_INFO</code> で受け取ります。 実際の Key をスクリーンショット、workflow、ログ、リポジトリに含めないでください。 ### 環境変数を使った起動例 Windows： ~~~shell set TRIPO_API_KEY=tsk_XXXXXXX python.exe main.py [--cpu] ~~~ Linux または macOS： ~~~bash TRIPO_API_KEY=tsk_XXXXXXX python main.py [--cpu] ~~~ ## ノード一覧 ComfyUI-Tripo には次の 11 個の Tripo ノードがあります。 | 内部 ID | 表示名 | 機能 | 出力 | | --- | --- | --- | --- | | <code>TripoAPIDraft</code> | Tripo: Generate model | テキスト、画像、複数視点からモデルを生成します。 | STRING <code>model_file</code> + <code>MODEL_INFO</code> | | <code>TripoImportModel</code> | Tripo: Import model | ローカルモデルまたは URL をインポートします。 | <code>MODEL_INFO</code> | | <code>TripoTextureModel</code> | Tripo: Texture model | モデルにテクスチャを生成します。 | STRING <code>model_file</code> + <code>MODEL_INFO</code> | | <code>TripoRefineModel</code> | Tripo: Refine Draft model | 互換性のある草モデルを精修します。 | STRING <code>model_file</code> + <code>MODEL_INFO</code> | | <code>TripoMeshSegmentation</code> | Tripo: Segment mesh | メッシュを分割します。 | STRING <code>model_file</code> + <code>MODEL_INFO</code> | | <code>TripoMeshCompletion</code> | Tripo: Complete mesh | 分割済みメッシュを補完します。 | STRING <code>model_file</code> + <code>MODEL_INFO</code> | | <code>TripoSmartLowPoly</code> | Tripo: Smart low poly | 低ポリゴンモデルを生成します。 | STRING <code>model_file</code> + <code>MODEL_INFO</code> | | <code>TripoStylizeModel</code> | Tripo: Stylize model | 幾何学スタイルを適用します。 | STRING <code>model_file</code> + <code>MODEL_INFO</code> | | <code>TripoAnimateRigNode</code> | Tripo: Rig model | モデルを自動リグします。 | STRING <code>model_file</code> + <code>MODEL_INFO</code> | | <code>TripoAnimateRetargetNode</code> | Tripo: Retarget rigged model | プリセットアニメーションを適用します。 | STRING <code>model_file</code> + <code>MODEL_INFO</code> | | <code>TripoConvertNode</code> | Tripo: Convert model | モデルを変換して書き出します。 | STRING <code>model_file</code> | Preview 3D は ComfyUI のノードであり、11 個の Tripo ノードには含まれません。 ## 接続とデータフロー ~~~mermaid flowchart LR G["Generate model"] -->|MODEL_INFO| P["モデル処理"] I["Import model"] -->|MODEL_INFO| P P -->|MODEL_INFO| R["Rig model"] R -->|MODEL_INFO| A["Retarget rigged model"] A -->|MODEL_INFO| C["Convert model"] ~~~ - <code>model_file</code> は、プレビューやファイル処理に使うダウンロード済みファイルのパスです。 - <code>MODEL_INFO</code> には <code>task_id</code>、解決済み <code>apikey</code>、<code>file_prefix</code>、<code>output_directory</code> が含まれます。 - 外部モデルは最初に <code>TripoImportModel</code> を通す必要があり、ファイルパスだけでは <code>MODEL_INFO</code> の代わりになりません。 - Tripo の処理を続けるときは <code>MODEL_INFO</code> を接続します。 ## 全ノードパラメーター 「必須」はノード定義で必須とされている入力を示します。空の <code>apikey</code> は環境変数または設定へフォールバックできます。「—」は明示的なデフォルト値がないことを示します。 ### 生成とインポート ### TripoAPIDraft — Tripo: Generate model テキスト、画像、複数視点からモデルを生成します。 | 入力 | 型 | 必須 | デフォルト | 値 / 範囲 | | --- | --- | --- | --- | --- | | <code>mode</code> | ENUM | はい | 先頭値 | <code>text_to_model</code>, <code>image_to_model</code>, <code>multiview_to_model</code> | | <code>apikey</code> | STRING | はい | 空 | API key またはフォールバック | | <code>prompt</code> | STRING multiline | いいえ | 空 | <code>text_to_model</code> | | <code>negative_prompt</code> | STRING multiline | いいえ | 空 | — | | <code>image</code> | IMAGE | いいえ | — | <code>image_to_model</code> 入力元; <code>multiview_to_model</code> 正面画像 | | <code>image_left</code> | IMAGE | いいえ | — | <code>multiview_to_model</code> | | <code>image_back</code> | IMAGE | いいえ | — | <code>multiview_to_model</code> | | <code>image_right</code> | IMAGE | いいえ | — | <code>multiview_to_model</code> | | <code>model_version</code> | ENUM | いいえ | <code>v3.1-20260211</code> | <code>v1.4-20240625</code>, <code>v2.0-20240919</code>, <code>v2.5-20250123</code>, <code>v3.0-20250812</code>, <code>v3.1-20260211</code> | | <code>texture</code> | BOOLEAN | いいえ | <code>true</code> | — | | <code>pbr</code> | BOOLEAN | いいえ | <code>true</code> | — | | <code>image_seed</code> | INT | いいえ | <code>42</code> | <code>text_to_model</code> | | <code>model_seed</code> | INT | いいえ | <code>42</code> | — | | <code>texture_seed</code> | INT | いいえ | <code>42</code> | — | | <code>texture_quality</code> | ENUM | いいえ | <code>standard</code> | <code>standard</code>, <code>detailed</code> | | <code>geometry_quality</code> | ENUM | いいえ | <code>standard</code> | <code>standard</code>, <code>detailed</code>; <code>image_to_model</code> | | <code>texture_alignment</code> | ENUM | いいえ | <code>original_image</code> | <code>original_image</code>, <code>geometry</code> | | <code>face_limit</code> | INT | いいえ | <code>-1</code> | <code>-1</code>–<code>500000</code>; ≤ 0 は未設定として扱う | | <code>quad</code> | BOOLEAN | いいえ | <code>false</code> | — | | <code>compress</code> | BOOLEAN | いいえ | <code>false</code> | — | | <code>generate_parts</code> | BOOLEAN | いいえ | <code>false</code> | — | | <code>smart_low_poly</code> | BOOLEAN | いいえ | <code>false</code> | — | | <code>auto_size</code> | BOOLEAN | いいえ | <code>false</code> | — | | <code>orientation</code> | ENUM | いいえ | <code>default</code> | <code>default</code>, <code>align_image</code>; 画像/multiview モード | | <code>file_prefix</code> | STRING | いいえ | 空 | — | | <code>output_directory</code> | STRING | いいえ | 空 | — | **出力:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **前提:** なし. **主な失敗条件:** 条件入力/Key 不足、API タスクまたは出力移動の失敗. **最小接続:** テキスト/画像 → <code>TripoAPIDraft</code> → Preview 3D. 3 つのモードには次の条件付き必須入力があります。 | <code>mode</code> | 条件付き必須 | 説明 | | --- | --- | --- | | <code>text_to_model</code> | <code>prompt</code> | <code>prompt</code> を空にできません。 | | <code>image_to_model</code> | <code>image</code> | <code>image</code> が必須です。 | | <code>multiview_to_model</code> | <code>image</code> | <code>image</code> は正面で、左・背面・右は任意です。 | ### TripoImportModel — Tripo: Import model ローカルモデルまたは URL をインポートします。 | 入力 | 型 | 必須 | デフォルト | 値 / 範囲 | | --- | --- | --- | --- | --- | | <code>apikey</code> | STRING | はい | 空 | API key またはフォールバック | | <code>model_file</code> | file selector | いいえ | <code>none</code> | ComfyUI input ディレクトリ | | <code>model_url</code> | STRING | いいえ | 空 | 直接 URL | | <code>file_prefix</code> | STRING | いいえ | 空 | 後続へ引き継ぐ | | <code>output_directory</code> | STRING | いいえ | 空 | 後続へ引き継ぐ | **出力:** <code>MODEL_INFO</code>. **前提:** ローカルファイルまたは URL. **主な失敗条件:** 入力元なし/到達不能、形式拒否または import 失敗. **最小接続:** ローカルファイルまたは URL → <code>TripoImportModel</code> → MODEL_INFO. 空でない <code>model_url</code> は <code>model_file</code> より優先されます。両方が空なら失敗します。アップロードは <code>.glb</code>、<code>.fbx</code>、<code>.obj</code>、<code>.stl</code>、<code>.ply</code>、<code>.3mf</code>、<code>.gltf</code> を受け付け、バックエンドは <code>.zip</code> も認識します。 ### モデル処理 ### TripoTextureModel — Tripo: Texture model モデルにテクスチャを生成します。 | 入力 | 型 | 必須 | デフォルト | 値 / 範囲 | | --- | --- | --- | --- | --- | | <code>model_info</code> | MODEL_INFO | はい | — | 上流タスクコンテキスト | | <code>model_version</code> | ENUM | いいえ | <code>v3.0-20250812</code> | <code>v2.5-20250123</code>, <code>v3.0-20250812</code> | | <code>texture</code> | BOOLEAN | いいえ | <code>true</code> | — | | <code>pbr</code> | BOOLEAN | いいえ | <code>true</code> | — | | <code>texture_seed</code> | INT | いいえ | <code>42</code> | — | | <code>texture_quality</code> | ENUM | いいえ | <code>standard</code> | <code>standard</code>, <code>detailed</code> | | <code>texture_alignment</code> | ENUM | いいえ | <code>original_image</code> | <code>original_image</code>, <code>geometry</code> | | <code>text_prompt</code> | STRING multiline | いいえ | 空 | — | | <code>image_prompt</code> | IMAGE | いいえ | — | — | | <code>style_image</code> | IMAGE | いいえ | — | — | | <code>part_names</code> | STRING multiline | いいえ | 空 | 1 行に 1 部位名 | | <code>compress</code> | BOOLEAN | いいえ | <code>false</code> | — | | <code>bake</code> | BOOLEAN | いいえ | <code>true</code> | — | **出力:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **前提:** Generate / Import MODEL_INFO. **主な失敗条件:** 非互換コンテキスト、無効画像または API 失敗. **最小接続:** Generate / Import → <code>TripoTextureModel</code> → Preview 3D. ### TripoRefineModel — Tripo: Refine Draft model 互換性のある草モデルを精修します。 | 入力 | 型 | 必須 | デフォルト | 値 / 範囲 | | --- | --- | --- | --- | --- | | <code>model_info</code> | MODEL_INFO | はい | — | 草モデルコンテキスト | **出力:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **前提:** 精修可能な草モデルの MODEL_INFO. **主な失敗条件:** 精修不可の草モデルまたは API 失敗. **最小接続:** Generate draft → <code>TripoRefineModel</code> → Preview 3D. ### TripoMeshSegmentation — Tripo: Segment mesh メッシュを分割します。 | 入力 | 型 | 必須 | デフォルト | 値 / 範囲 | | --- | --- | --- | --- | --- | | <code>model_info</code> | MODEL_INFO | はい | — | 上流タスクコンテキスト | | <code>model_version</code> | ENUM | はい | <code>v1.0-20250506</code> | <code>v1.0-20250506</code>, <code>v2.0-20260430</code> | | <code>segmentation_granularity</code> | ENUM | いいえ | <code>balanced</code> | <code>simple</code>, <code>balanced</code>, <code>detailed</code>; v2 only | | <code>ref_image</code> | IMAGE | いいえ | — | v2 のみ | | <code>split_by_connectivity</code> | BOOLEAN | いいえ | <code>true</code> | v2 のみ | **出力:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **前提:** Generate / Import MODEL_INFO. **主な失敗条件:** 非互換モデル/参照画像または API 失敗. **最小接続:** Generate / Import → <code>TripoMeshSegmentation</code> → Completion / Preview. <code>segmentation_granularity</code>、<code>ref_image</code>、<code>split_by_connectivity</code> は <code>v2.0-20260430</code> の場合だけ送信され、v1 では無視されます。 ### TripoMeshCompletion — Tripo: Complete mesh 分割済みメッシュを補完します。 | 入力 | 型 | 必須 | デフォルト | 値 / 範囲 | | --- | --- | --- | --- | --- | | <code>model_info</code> | MODEL_INFO | はい | — | 分割済みコンテキスト | | <code>model_version</code> | ENUM | はい | <code>v1.0-20250506</code> | <code>v1.0-20250506</code> | | <code>part_names</code> | STRING multiline | いいえ | 空 | 1 行に 1 部位名 | **出力:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **前提:** 分割済み MODEL_INFO. **主な失敗条件:** 補完に不適切なタスクまたは API 失敗. **最小接続:** Segment → <code>TripoMeshCompletion</code> → Preview 3D. ### TripoSmartLowPoly — Tripo: Smart low poly 低ポリゴンモデルを生成します。 | 入力 | 型 | 必須 | デフォルト | 値 / 範囲 | | --- | --- | --- | --- | --- | | <code>model_info</code> | MODEL_INFO | はい | — | 上流タスクコンテキスト | | <code>model_version</code> | ENUM | はい | <code>P-v2.0-20251225</code> | <code>P-v2.0-20251225</code> | | <code>quad</code> | BOOLEAN | いいえ | <code>false</code> | — | | <code>part_names</code> | STRING multiline | いいえ | 空 | 1 行に 1 部位名 | | <code>face_limit</code> | INT | いいえ | <code>10000</code> | <code>-1</code>–<code>20000</code> | | <code>bake</code> | BOOLEAN | いいえ | <code>true</code> | — | **出力:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **前提:** Generate / Import MODEL_INFO. **主な失敗条件:** 非互換モデル/部位または API 失敗. **最小接続:** Generate / Import → <code>TripoSmartLowPoly</code> → Preview / Convert. ### TripoStylizeModel — Tripo: Stylize model 幾何学スタイルを適用します。 | 入力 | 型 | 必須 | デフォルト | 値 / 範囲 | | --- | --- | --- | --- | --- | | <code>model_info</code> | MODEL_INFO | はい | — | 上流タスクコンテキスト | | <code>style</code> | ENUM | はい | 先頭値 | <code>lego</code>, <code>voxel</code>, <code>voronoi</code>, <code>minecraft</code> | | <code>block_size</code> | INT | はい | <code>80</code> | <code>1</code>–<code>1000</code> | **出力:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **前提:** Generate / Import MODEL_INFO. **主な失敗条件:** 非互換モデル/スタイルまたは API 失敗. **最小接続:** Generate / Import → <code>TripoStylizeModel</code> → Preview 3D. ### リグとアニメーション ### TripoAnimateRigNode — Tripo: Rig model モデルを自動リグします。 | 入力 | 型 | 必須 | デフォルト | 値 / 範囲 | | --- | --- | --- | --- | --- | | <code>model_info</code> | MODEL_INFO | はい | — | 上流タスクコンテキスト | | <code>model_version</code> | ENUM | はい | <code>v2.0-20250506</code> | <code>v1.0-20240301</code>, <code>v2.0-20250506</code> | | <code>out_format</code> | ENUM | はい | <code>glb</code> | <code>glb</code>, <code>fbx</code> | | <code>spec</code> | ENUM | はい | <code>tripo</code> | <code>mixamo</code>, <code>tripo</code> | **出力:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **前提:** Generate / Import MODEL_INFO. **主な失敗条件:** リグ不可、rig type なし、または API 失敗. **最小接続:** Generate / Import → <code>TripoAnimateRigNode</code> → Retarget / Preview. リグ処理の前に、ノードはリグ可能か確認し rig type を取得します。 ### TripoAnimateRetargetNode — Tripo: Retarget rigged model プリセットアニメーションを適用します。 | 入力 | 型 | 必須 | デフォルト | 値 / 範囲 | | --- | --- | --- | --- | --- | | <code>model_info</code> | MODEL_INFO | はい | — | リグ済みコンテキスト | | <code>animation</code> | ENUM | はい | 先頭値 | 下記 16 プリセット | | <code>out_format</code> | ENUM | はい | <code>glb</code> | <code>glb</code>, <code>fbx</code> | | <code>bake_animation</code> | BOOLEAN | いいえ | <code>true</code> | — | | <code>export_with_geometry</code> | BOOLEAN | いいえ | <code>false</code> | — | **出力:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **前提:** リグ済み MODEL_INFO. **主な失敗条件:** 未リグコンテキストまたは API 失敗. **最小接続:** Rig → <code>TripoAnimateRetargetNode</code> → Preview / Convert. 16 個のアニメーション値: <code>preset:idle</code>, <code>preset:walk</code>, <code>preset:run</code>, <code>preset:dive</code>, <code>preset:climb</code>, <code>preset:jump</code>, <code>preset:slash</code>, <code>preset:shoot</code>, <code>preset:hurt</code>, <code>preset:fall</code>, <code>preset:turn</code>, <code>preset:quadruped:walk</code>, <code>preset:hexapod:walk</code>, <code>preset:octopod:walk</code>, <code>preset:serpentine:march</code>, <code>preset:aquatic:march</code>. ### 形式出力 ### TripoConvertNode — Tripo: Convert model モデルを変換して書き出します。 | 入力 | 型 | 必須 | デフォルト | 値 / 範囲 | | --- | --- | --- | --- | --- | | <code>model_info</code> | MODEL_INFO | はい | — | 上流タスクコンテキスト | | <code>format</code> | ENUM | はい | 先頭値 | <code>GLTF</code>, <code>USDZ</code>, <code>FBX</code>, <code>OBJ</code>, <code>STL</code>, <code>3MF</code> | | <code>quad</code> | BOOLEAN | いいえ | <code>false</code> | — | | <code>force_symmetry</code> | BOOLEAN | いいえ | <code>false</code> | — | | <code>face_limit</code> | INT | いいえ | <code>-1</code> | <code>-1</code>–<code>500000</code> | | <code>flatten_bottom</code> | BOOLEAN | いいえ | <code>false</code> | — | | <code>flatten_bottom_threshold</code> | FLOAT | いいえ | <code>0.01</code> | <code>0.0</code>–<code>1.0</code> | | <code>texture_size</code> | INT | いいえ | <code>4096</code> | <code>128</code>–<code>4096</code> | | <code>texture_format</code> | ENUM | いいえ | <code>JPEG</code> | <code>BMP</code>, <code>DPX</code>, <code>HDR</code>, <code>JPEG</code>, <code>OPEN_EXR</code>, <code>PNG</code>, <code>TARGA</code>, <code>TIFF</code>, <code>WEBP</code> | | <code>pivot_to_center_bottom</code> | BOOLEAN | いいえ | <code>false</code> | — | | <code>scale_factor</code> | FLOAT | いいえ | <code>1.0</code> | 最小 <code>0</code> | | <code>with_animation</code> | BOOLEAN | いいえ | <code>true</code> | — | | <code>pack_uv</code> | BOOLEAN | いいえ | <code>false</code> | — | | <code>bake</code> | BOOLEAN | いいえ | <code>true</code> | — | | <code>part_names</code> | STRING multiline | いいえ | 空 | 1 行に 1 部位名 | | <code>fbx_preset</code> | ENUM | いいえ | <code>blender</code> | <code>blender</code>, <code>mixamo</code>, <code>3dsmax</code> | | <code>export_vertex_colors</code> | BOOLEAN | いいえ | <code>false</code> | — | | <code>export_orientation</code> | ENUM | いいえ | <code>+x</code> | <code>+x</code>, <code>+y</code>, <code>-x</code>, <code>-y</code> | | <code>animate_in_place</code> | BOOLEAN | いいえ | <code>false</code> | — | **出力:** STRING <code>model_file</code>. **前提:** 互換性のある MODEL_INFO. **主な失敗条件:** 未対応変換、無効設定または出力失敗. **最小接続:** MODEL_INFO → <code>TripoConvertNode</code>. Convert は出力ノードで、<code>MODEL_INFO</code> を返しません。 ## workflow 例 Preview 3D は任意の ComfyUI ビューアーです。 ~~~mermaid flowchart LR T["テキスト"] --> GT["Generate model<br/>mode: text_to_model"] IM["画像"] --> GI["Generate model<br/>mode: image_to_model"] MV["正面 + 任意ビュー"] --> GM["Generate model<br/>mode: multiview_to_model"] GT --> V["Preview 3D"] GI --> V GM --> V ~~~ 1. **Text to Model:** <code>prompt</code> → <code>text_to_model</code> の Generate → Preview 3D。 2. **Image to Model:** IMAGE → <code>image</code>、<code>image_to_model</code> → Preview 3D。 3. **Multiview to Model:** 正面を <code>image</code>、任意画像を <code>image_left</code>、<code>image_back</code>、<code>image_right</code> へ接続。 4. **Texture Model:** Generate/Import → MODEL_INFO → Texture → Preview。 5. **Refine Model:** 互換草モデル → MODEL_INFO → Refine → Preview。 6. **Rig and Retarget:** Generate/Import → Rig → Retarget。各接続は MODEL_INFO。 7. **Import and Process:** ファイル/URL → Import → Segment/Smart low poly/Stylize/Texture。 8. **Convert and Export:** 最終 MODEL_INFO → Convert → 形式を選択。 ### 公式 workflow PNG 次の 6 個の PNG には ComfyUI workflow データが埋め込まれています。ダウンロードリンクから原本を保存し、ComfyUI にドラッグするか手動で読み込んでください。画像内のパラメーター値は例です。現在のデフォルト値はパラメーター表を参照してください。 #### Text to Mesh  テキストからモデルを生成し、<code>model_file</code> を Preview 3D に渡します。 <a href="/assets/images/docs/comfyui-nodes/text_to_model.png" download>元の workflow PNG をダウンロード</a> #### Image to Mesh  画像を読み込み、<code>image_to_model</code> モードの Generate model に接続して結果を表示します。 <a href="/assets/images/docs/comfyui-nodes/image_to_model.png" download>元の workflow PNG をダウンロード</a> #### Multiview Images to Mesh  正面画像と任意の側面画像を <code>multiview_to_model</code> モードの Generate model に接続します。 <a href="/assets/images/docs/comfyui-nodes/multiview_to_model.png" download>元の workflow PNG をダウンロード</a> #### Texture a generated model  Generate model の <code>MODEL_INFO</code> を Texture model に渡し、両方の出力を表示します。 <a href="/assets/images/docs/comfyui-nodes/texture_model.png" download>元の workflow PNG をダウンロード</a> #### Refine a draft Mesh  互換性のあるドラフトを生成し、<code>MODEL_INFO</code> を Refine Draft model に渡して結果を表示します。 <a href="/assets/images/docs/comfyui-nodes/refine_model.png" download>元の workflow PNG をダウンロード</a> #### Animation / Rig and export  <a href="/assets/images/docs/comfyui-nodes/retarget.png" download>元の workflow PNG をダウンロード</a> ## 出力とトラブルシューティング ダウンロード先のデフォルトは <code>ComfyUI/output</code> です。<code>file_prefix</code> は名前を変更し、<code>output_directory</code> は移動先を指定します。どちらも <code>MODEL_INFO</code> で引き継がれます。 | 症状 | 確認 | | --- | --- | | API Key がない | ノード Key、<code>TRIPO_API_KEY</code>、または <code>config.json</code> を設定します。 | | prompt/正面画像がない | mode と条件付き入力を確認します。 | | Import が開始しない | 到達可能な URL または既存ファイルを指定します。URL が優先です。 | | リグできない | 適切なキャラクターモデルを使用します。 | | API タスク失敗 | <code>error_code</code>、<code>error_msg</code>、権限、残高を確認します。 | | 出力を移動できない | 移動先と書き込み権限を確認します。 | | ノードが表示されない | ComfyUI を再起動し、ディレクトリと <code>requirements.txt</code> を確認します。 | | アップロード失敗 | 拡張子と ComfyUI の応答を確認します。 |

comfy node registry-install comfyui-tripo

cd ComfyUI/custom_nodes
git clone https://github.com/VAST-AI-Research/ComfyUI-Tripo.git
python -m pip install -r ComfyUI-Tripo/requirements.txt

set TRIPO_API_KEY=tsk_XXXXXXX
python.exe main.py [--cpu]

TRIPO_API_KEY=tsk_XXXXXXX python main.py [--cpu]

flowchart LR
    G["Generate model"] -->|MODEL_INFO| P["モデル処理"]
    I["Import model"] -->|MODEL_INFO| P
    P -->|MODEL_INFO| R["Rig model"]
    R -->|MODEL_INFO| A["Retarget rigged model"]
    A -->|MODEL_INFO| C["Convert model"]

flowchart LR
    T["テキスト"] --> GT["Generate model<br/>mode: text_to_model"]
    IM["画像"] --> GI["Generate model<br/>mode: image_to_model"]
    MV["正面 + 任意ビュー"] --> GM["Generate model<br/>mode: multiview_to_model"]
    GT --> V["Preview 3D"]
    GI --> V
    GM --> V