TripoImageToModelNode - ComfyUI Built-in Node Documentation - ComfyUI

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

入力

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

Source fingerprint (SHA-256): 3b278abfd13329ee58ebab1bfeb47d32d09f4797f3d8628a35a028c3d15a7314