> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# TripoImageToModelNodeV2 - ComfyUI Built-in Node Documentation

> Tripo: Image to Model ノードは、Tripo の image-to-model サービスを使用して、単一の参照画像から 3D モデルを生成します。

Tripo: Image to Model ノードは、Tripo の image-to-model サービスを使用して、単一の参照画像から 3D モデルを生成します。画像をアップロードし、生成タスクを送信し、タスクの完了を待機して、生成された 3D ファイルをタスク ID とともに返します。これは API ノードであるため、有効な Comfy API キーが必要です。

## 入力

| パラメータ       | 説明                                                                                                                                                    | データ型    | 必須  | 範囲                                        |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | --- | ----------------------------------------- |
| `画像`        | 3D モデルの生成に使用する参照画像。                                                                                                                                   | IMAGE   | はい  | —                                         |
| `モデルバージョン`  | 生成に使用するモデルバージョン。未設定の場合、ノードは Tripo の v3.1 (20260211) バージョンにフォールバックします。                                                                                 | COMBO   | いいえ | Tripo モデルバージョンのリスト                        |
| `テクスチャ`     | テクスチャマップを生成します。オフにするとテクスチャのないジオメトリを返し、`pbr` は無視されます（デフォルト: true）。                                                                                     | BOOLEAN | いいえ | true<br />false                           |
| `pbr`       | PBR マテリアルマップ（ベースカラー、メタリック、ラフネス、ノーマル）。`texture` が必要です（デフォルト: true）。                                                                                    | BOOLEAN | いいえ | true<br />false                           |
| `モデルシード`    | ジオメトリ生成ステップで使用するシード（デフォルト: 42）。                                                                                                                       | INT     | いいえ | 0 ～ 2147483647                            |
| `向き`        | 生成されたモデルに適用される向き設定（デフォルト: DEFAULT）。                                                                                                                   | COMBO   | いいえ | Tripo の向きオプション、デフォルト `DEFAULT`            |
| `テクスチャシード`  | テクスチャ生成ステップで使用するシード（デフォルト: 42）。                                                                                                                       | INT     | いいえ | 0 ～ 2147483647                            |
| `テクスチャ品質`   | detailed = HD テクスチャ、extreme = 8K Ultra テクスチャ（デフォルト: "standard"）。                                                                                      | COMBO   | いいえ | "standard"<br />"detailed"<br />"extreme" |
| `テクスチャ配置`   | 生成されたジオメトリ上でテクスチャをどのように整列させるか（デフォルト: "original\_image"）。                                                                                              | COMBO   | いいえ | "original\_image"<br />"geometry"         |
| `面数上限`      | 最大フェイス数。-1 を指定すると Tripo が適応的に選択します（v3.x standard では約 140 万フェイス、detailed では 200 万）。Tripo は通知なしでクランプします: v2.5 では 500,000、クアッドメッシュでは 150,000（デフォルト: -1）。 | INT     | いいえ | -1 ～ 2000000                              |
| `四角形`       | クアッドメッシュ出力。Tripo はクアッドメッシュを FBX として提供するため、結果は FBX 出力に渡され、GLB 出力は空のままです（デフォルト: false）。                                                                 | BOOLEAN | いいえ | true<br />false                           |
| `ジオメトリ品質`   | 生成されるジオメトリの品質レベル（デフォルト: "standard"）。                                                                                                                  | COMBO   | いいえ | "standard"<br />"detailed"                |
| `スマート低ポリゴン` | クリーンで手作りのようなスタイルのトポロジーを持つローポリメッシュ（500～20,000 フェイス、クアッドでは 500～10,000）。単純な被写体に最適です。複雑な被写体では失敗する可能性があります（デフォルト: false）。                                  | BOOLEAN | いいえ | true<br />false                           |
| `自動サイズ`     | テクスチャ付きモデルを実世界のサイズ（メートル）にスケーリングします。Tripo はサイズをモデルのシーントランスフォームとして保存し、モデルの変換、リギング、リターゲティング時にベイクします。テクスチャがない場合は無視されます（デフォルト: true）。                      | BOOLEAN | いいえ | true<br />false                           |

**注記:**

* `image` は必須です。画像が指定されていない場合、ノードはエラーを発生させます。
* `smart_low_poly` が有効で、`face_limit` に -1 以外の値が設定されている場合、制限値は三角形メッシュでは 500 ～ 20,000、`quad` が有効な場合は 500 ～ 10,000 の範囲内である必要があります。それ以外の値はエラーになります。
* `texture` が無効な場合、`pbr` はその設定に関係なく強制的にオフになり、`auto_size` は効果がありません。
* `face_limit` の -1 は "no limit" として Tripo に送信され、サービスが適応的に選択できるようになります。
* ノードが返すことのできない新しい 3D ファイル形式（GLB または FBX 以外）はエラーを引き起こします。

## 出力

| 出力名             | 説明                                         | データ型            |
| --------------- | ------------------------------------------ | --------------- |
| `model task_id` | 生成ジョブの Tripo タスク ID。                       | MODEL\_TASK\_ID |
| `GLB`           | 生成されたモデル（GLB ファイル）。`quad` が有効な場合は空です。      | FILE3DGLB       |
| `FBX`           | 生成されたモデル（FBX ファイル）。`quad` が有効な場合にのみ設定されます。 | FILE3DFBX       |

> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください！ [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TripoImageToModelNodeV2/ja.md)

***

**Source fingerprint (SHA-256):** `c8c069432f67a019995b9f4dedbf5ca3f7594ae4004104277068106821189c11`
