MeshyImageToModelNode - ComfyUI 組み込みノードのドキュメント

ComfyUI における MeshyImageToModelNode ノードの完全なドキュメントです。入力、出力、パラメーターおよび使用方法について学びましょう。

このドキュメントは AI によって生成されました。誤りを発見された場合、または改善に関するご提案がある場合は、ぜひ貢献してください！ GitHub で編集

「Meshy: Image to Model」ノードは Meshy API を使用して、単一の入力画像から 3D モデルを生成します。このノードは、ユーザーの画像をアップロードし、処理タスクを送信した後、生成された 3D モデルファイル（GLB および FBX 形式）と、参照用のタスク ID を返します。

​

入力

パラメーター	データ型	必須	範囲	説明
model	COMBO	はい	"latest"	生成に使用する AI モデルのバージョンを指定します。
image	IMAGE	はい	-	3D モデルに変換する入力画像です。
should_remesh	DYNAMIC COMBO	はい	"true" "false"	生成されたメッシュを再メッシュ処理するかどうかを決定します。"false" に設定すると、ノードは未処理の三角形メッシュを返します。
topology	COMBO	いいえ*	"triangle" "quad"	再メッシュ後のモデルの対象となるポリゴントポロジーです。この入力は、should_remesh が "true" に設定されている場合にのみ利用可能かつ必須となります。
target_polycount	INT	いいえ*	100 – 300000	再メッシュ後のモデルの対象ポリゴン数です。この入力は、should_remesh が "true" に設定されている場合にのみ利用可能かつ必須となります。デフォルト値は 300000 です。
symmetry_mode	COMBO	はい	"auto" "on" "off"	生成された 3D モデルに適用される対称性を制御します。
should_texture	DYNAMIC COMBO	はい	"true" "false"	モデルに対してテクスチャを生成するかどうかを決定します。"false" に設定すると、テクスチャ生成フェーズがスキップされ、テクスチャなしのメッシュが返されます。
enable_pbr	BOOLEAN	いいえ*	-	should_texture が "true" の場合、このオプションにより、ベースカラーに加えて PBR マップ（メタリック、ラフネス、法線）が生成されます。デフォルト値は False です。
texture_prompt	STRING	いいえ*	-	テクスチャ生成プロセスをガイドするためのテキストプロンプトです（最大 600 文字）。この入力は、should_texture が "true" に設定されている場合にのみ利用可能です。texture_image と同時に使用することはできません。
texture_image	IMAGE	いいえ*	-	テクスチャ生成プロセスをガイドするための画像です。この入力は、should_texture が "true" に設定されている場合にのみ利用可能です。texture_prompt と同時に使用することはできません。
pose_mode	COMBO	はい	"" "A-pose" "T-pose"	生成されるモデルのポーズモードを指定します。
seed	INT	はい	0 – 2147483647	生成プロセスのシード値です。結果はシード値に関わらず非決定的です。デフォルト値は 0 です。

パラメーター制約に関する注意事項：

• topology および target_polycount の入力は、should_remesh が "true" に設定されている場合にのみ必須です。
• enable_pbr、texture_prompt、texture_image の入力は、should_texture が "true" に設定されている場合にのみ利用可能です。
• texture_prompt と texture_image を同時に使用することはできません。should_texture が "true" の状態で両方の入力が提供された場合、ノードはエラーを発生させます。

​

出力

出力名	データ型	説明
model_file	STRING	生成された GLB モデルのファイル名です。（下位互換性維持のため保持されています）。
meshy_task_id	MESHY_TASK_ID	Meshy API タスクの固有識別子であり、参照やトラブルシューティングに使用できます。
GLB	FILE3DGLB	GLB ファイル形式で生成された 3D モデルです。
FBX	FILE3DFBX	FBX ファイル形式で生成された 3D モデルです。