# 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

![Tripo Generate model と Preview 3D を接続したテキストからメッシュの workflow](/assets/images/docs/comfyui-nodes/text_to_model.png)

テキストからモデルを生成し、<code>model_file</code> を Preview 3D に渡します。

<a href="/assets/images/docs/comfyui-nodes/text_to_model.png" download>元の workflow PNG をダウンロード</a>

#### Image to Mesh

![Load Image、Tripo Generate model、Preview 3D を接続した画像からメッシュの workflow](/assets/images/docs/comfyui-nodes/image_to_model.png)

画像を読み込み、<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

![3 個の Load Image、Tripo Generate model、Preview 3D を接続したマルチビュー workflow](/assets/images/docs/comfyui-nodes/multiview_to_model.png)

正面画像と任意の側面画像を <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、Texture model、Preview 3D を接続したテクスチャ workflow](/assets/images/docs/comfyui-nodes/texture_model.png)

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

![Generate model、Refine Draft model、Preview 3D を接続した精製 workflow](/assets/images/docs/comfyui-nodes/refine_model.png)

互換性のあるドラフトを生成し、<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

![Generate model、Rig model、Preview 3D、Convert model を接続したリグと出力の workflow](/assets/images/docs/comfyui-nodes/retarget.png)

<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 の応答を確認します。 |