このドキュメントは AI によって生成されました。誤りを発見された場合、または改善に関するご提案がある場合は、ぜひご貢献ください! GitHub で編集このノードは Meshy API を使用して、複数の入力画像から 3D モデルを生成します。指定された画像をアップロードし、処理タスクを送信した後、生成された 3D モデルファイル(GLB 形式および FBX 形式)と参照用のタスク ID を返します。
入力
| パラメーター | データ型 | 必須 | 範囲 | 説明 |
|---|---|---|---|---|
model | COMBO | はい | "latest" | 使用する AI モデルのバージョンを指定します。 |
images | IMAGE | はい | 2~4 枚の画像 | 3D モデル生成に使用される一連の画像です。2 枚以上 4 枚以下の画像を必ず指定してください。 |
should_remesh | COMBO | はい | "true""false" | 生成されたメッシュを再メッシュ処理するかどうかを決定します。"false" に設定すると、ノードは未処理の三角形メッシュを返します。 |
topology | COMBO | いいえ | "triangle""quad" | 再メッシュ後の出力におけるターゲット多角形タイプです。このパラメーターは、should_remesh が "true" に設定されている場合にのみ利用可能かつ必須となります。 |
target_polycount | INT | いいえ | 100~300000 | 再メッシュ後のモデルにおけるターゲットポリゴン数(デフォルト値:300000)。このパラメーターは、should_remesh が "true" に設定されている場合にのみ利用可能です。 |
symmetry_mode | COMBO | はい | "auto""on""off" | 生成されたモデルに対して対称性を適用するかどうかを制御します。 |
should_texture | COMBO | はい | "true""false" | テクスチャを生成するかどうかを決定します。"false" に設定すると、テクスチャ生成フェーズがスキップされ、テクスチャなしのメッシュが返されます。 |
enable_pbr | BOOLEAN | いいえ | True / False | should_texture が "true" の場合、このオプションはベースカラーに加えて PBR マップ(メタリック、ラフネス、法線)を生成します(デフォルト値:False)。 |
texture_prompt | STRING | いいえ | - | テクスチャ生成プロセスをガイドするためのテキストプロンプト(最大 600 文字)。texture_image と同時に使用することはできません。このパラメーターは、should_texture が "true" に設定されている場合にのみ利用可能です。 |
texture_image | IMAGE | いいえ | - | テクスチャ生成プロセスをガイドするための画像です。texture_image と texture_prompt のどちらか一方のみを同時に使用できます。このパラメーターは、should_texture が "true" に設定されている場合にのみ利用可能です。 |
pose_mode | COMBO | はい | """A-pose""T-pose" | 生成されるモデルのポーズモードを指定します。 |
seed | INT | はい | 0~2147483647 | 生成プロセスのシード値(デフォルト値:0)。結果はシード値に関係なく非決定的ですが、シード値を変更することでノードの再実行をトリガーできます。 |
images入力には、必ず 2 枚以上 4 枚以下の画像を指定する必要があります。topologyおよびtarget_polycountパラメーターは、should_remeshが"true"に設定されている場合にのみ有効です。enable_pbr、texture_prompt、texture_imageパラメーターは、should_textureが"true"に設定されている場合にのみ有効です。texture_promptとtexture_imageを同時に使用することはできません。これらは相互に排他的です。
出力
| 出力名 | データ型 | 説明 |
|---|---|---|
model_file | STRING | 生成された GLB モデルのファイル名です。この出力は下位互換性のために提供されています。 |
meshy_task_id | MESHY_TASK_ID | Meshy API タスクの固有識別子です。 |
GLB | FILE3DGLB | GLB 形式で生成された 3D モデルです。 |
FBX | FILE3DFBX | FBX 形式で生成された 3D モデルです。 |