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

# TripoImageToModelNode - ComfyUI Built-in Node Documentation

> Tripo の API を使用して、単一の画像から同期的に 3D モデルを生成します。

Tripo の API を使用して、単一の画像から同期的に 3D モデルを生成します。入力画像を指定すると、このノードはそれから完成した 3D モデルを作成します。モデルバージョン、テクスチャ生成、詳細度、出力形式を任意で制御できます。これは image-to-model ノードのレガシーバージョンで、古いワークフロー用に維持されています。

## 入力

| パラメータ               | 説明                                                                                                                                                          | データ型    | 必須  | 範囲                                                                                                 |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | --- | -------------------------------------------------------------------------------------------------- |
| `image`             | 3D モデルの生成に使用する入力画像です。画像を指定する必要があり、指定しない場合、ノードはエラーを発生させます。                                                                                                   | IMAGE   | はい  | -                                                                                                  |
| `model_version`     | 生成に使用するモデルバージョンです。                                                                                                                                          | COMBO   | いいえ | `"v1.4"`<br />`"v3.0"`<br />`"v3.5"`<br />`"v3.6"`                                                 |
| `style`             | Tripo では現在サポートされておらず、無視されます。古いワークフロー用に維持されています。（デフォルト: `"None"`）                                                                                            | COMBO   | いいえ | `"None"`<br />`"realistic"`<br />`"cartoon"`<br />`"sculpture"`<br />`"low_poly"`                  |
| `texture`           | テクスチャマップを生成します。オフにすると、ベアジオメトリのみを返し、`pbr` は無視されます。（デフォルト: True）                                                                                              | BOOLEAN | いいえ | True<br />False                                                                                    |
| `pbr`               | PBR マテリアルマップ（ベースカラー、メタリック、ラフネス、ノーマル）です。`texture` が必要です。（デフォルト: True）                                                                                        | BOOLEAN | いいえ | True<br />False                                                                                    |
| `model_seed`        | モデル生成用のランダムシードです。（デフォルト: 42）                                                                                                                                | INT     | いいえ | 0～2147483647                                                                                       |
| `orientation`       | 生成されたモデルの向き設定です。（デフォルト: `"default"`）                                                                                                                        | COMBO   | いいえ | `"default"`<br />`"front"`<br />`"back"`<br />`"left"`<br />`"right"`<br />`"top"`<br />`"bottom"` |
| `texture_seed`      | テクスチャ生成用のランダムシードです。（デフォルト: 42）                                                                                                                              | INT     | いいえ | 0～2147483647                                                                                       |
| `texture_quality`   | テクスチャ生成の品質レベルです。`detailed` = HD テクスチャ、`extreme` = 8K Ultra テクスチャ。（デフォルト: `"standard"`）                                                                      | COMBO   | いいえ | `"standard"`<br />`"detailed"`<br />`"extreme"`                                                    |
| `texture_alignment` | テクスチャマッピングの位置合わせ方法です。（デフォルト: `"original_image"`）                                                                                                            | COMBO   | いいえ | `"original_image"`<br />`"geometry"`                                                               |
| `face_limit`        | 最大フェイス数です。-1 にすると Tripo が適応的に選択します（v3.x standard では約 140 万フェイス、detailed では 200 万フェイス）。Tripo は通知なしにクランプします。v2.5 では 500,000、クアッドメッシュでは 150,000 です。（デフォルト: -1） | INT     | いいえ | -1～2000000                                                                                         |
| `quad`              | クアッドメッシュを出力します。Tripo はクアッドメッシュを FBX として提供するため、結果は FBX 出力に渡され、GLB 出力は空のままです。（デフォルト: False）                                                                   | BOOLEAN | いいえ | True<br />False                                                                                    |
| `ジオメトリ品質`           | ジオメトリ生成の品質レベルです。（デフォルト: `"standard"`）                                                                                                                       | COMBO   | いいえ | `"standard"`<br />`"detailed"`                                                                     |
| `smart_low_poly`    | クリーンで手作り風のトポロジーを持つローポリメッシュです（500～20,000 フェイス、クアッドでは 500～10,000）。単純な被写体に最適で、複雑なものは失敗する場合があります。（デフォルト: False）                                                 | BOOLEAN | いいえ | True<br />False                                                                                    |
| `auto_size`         | テクスチャ付きモデルを実世界のメートル単位のサイズにスケーリングします。Tripo はサイズをモデルのシーン変換として保存し、モデルが変換、リギング、リターゲティングされるときにベイクします。テクスチャがない場合は無視されます。（デフォルト: True）                             | BOOLEAN | いいえ | True<br />False                                                                                    |

注: `image` は必須です。存在しない場合、ノードは RuntimeError を発生させます。`texture` が False の場合、モデルにはベアジオメトリのみが含まれ、`pbr` は強制的に False になります。`smart_low_poly` が有効な場合、`face_limit` は三角形メッシュでは 500～20,000、`quad` も有効な場合は 500～10,000 の範囲である必要があります。制限値が無効な場合、ノードは ValueError を発生させます。`face_limit` を -1（デフォルト）に設定すると、API に明示的なフェイス制限を送信せず、Tripo に適応的に選択させます。

## 出力

| 出力名        | 説明                                            | データ型            |
| ---------- | --------------------------------------------- | --------------- |
| `モデルファイル`  | 生成された 3D モデルファイル（後方互換性のみ）。                    | STRING          |
| `モデルタスクID` | モデル生成プロセスを追跡するためのタスク ID です。                   | MODEL\_TASK\_ID |
| `GLB`      | GLB 形式の生成された 3D モデルです。`quad` が有効な場合は空です。      | FILE3DGLB       |
| `FBX`      | FBX 形式の生成された 3D モデルです。`quad` が有効な場合にのみ設定されます。 | FILE3DFBX       |

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

***

**Source fingerprint (SHA-256):** `3b278abfd13329ee58ebab1bfeb47d32d09f4797f3d8628a35a028c3d15a7314`
