このドキュメントは 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 モデルです。 |