メインコンテンツへスキップ
このドキュメントは AI によって生成されました。誤りを発見された場合、または改善に関するご提案がある場合は、ぜひご貢献ください! GitHub で編集
このノードは Meshy API を使用して、複数の入力画像から 3D モデルを生成します。指定された画像をアップロードし、処理タスクを送信した後、生成された 3D モデルファイル(GLB 形式および FBX 形式)と参照用のタスク ID を返します。

入力

パラメーターデータ型必須範囲説明
modelCOMBOはい"latest"使用する AI モデルのバージョンを指定します。
imagesIMAGEはい2~4 枚の画像3D モデル生成に使用される一連の画像です。2 枚以上 4 枚以下の画像を必ず指定してください。
should_remeshCOMBOはい"true"
"false"
生成されたメッシュを再メッシュ処理するかどうかを決定します。"false" に設定すると、ノードは未処理の三角形メッシュを返します。
topologyCOMBOいいえ"triangle"
"quad"
再メッシュ後の出力におけるターゲット多角形タイプです。このパラメーターは、should_remesh"true" に設定されている場合にのみ利用可能かつ必須となります。
target_polycountINTいいえ100~300000再メッシュ後のモデルにおけるターゲットポリゴン数(デフォルト値:300000)。このパラメーターは、should_remesh"true" に設定されている場合にのみ利用可能です。
symmetry_modeCOMBOはい"auto"
"on"
"off"
生成されたモデルに対して対称性を適用するかどうかを制御します。
should_textureCOMBOはい"true"
"false"
テクスチャを生成するかどうかを決定します。"false" に設定すると、テクスチャ生成フェーズがスキップされ、テクスチャなしのメッシュが返されます。
enable_pbrBOOLEANいいえTrue / Falseshould_texture"true" の場合、このオプションはベースカラーに加えて PBR マップ(メタリック、ラフネス、法線)を生成します(デフォルト値:False)。
texture_promptSTRINGいいえ-テクスチャ生成プロセスをガイドするためのテキストプロンプト(最大 600 文字)。texture_image と同時に使用することはできません。このパラメーターは、should_texture"true" に設定されている場合にのみ利用可能です。
texture_imageIMAGEいいえ-テクスチャ生成プロセスをガイドするための画像です。texture_imagetexture_prompt のどちらか一方のみを同時に使用できます。このパラメーターは、should_texture"true" に設定されている場合にのみ利用可能です。
pose_modeCOMBOはい""
"A-pose"
"T-pose"
生成されるモデルのポーズモードを指定します。
seedINTはい0~2147483647生成プロセスのシード値(デフォルト値:0)。結果はシード値に関係なく非決定的ですが、シード値を変更することでノードの再実行をトリガーできます。
パラメーター制約:
  • images 入力には、必ず 2 枚以上 4 枚以下の画像を指定する必要があります。
  • topology および target_polycount パラメーターは、should_remesh"true" に設定されている場合にのみ有効です。
  • enable_pbrtexture_prompttexture_image パラメーターは、should_texture"true" に設定されている場合にのみ有効です。
  • texture_prompttexture_image を同時に使用することはできません。これらは相互に排他的です。

出力

出力名データ型説明
model_fileSTRING生成された GLB モデルのファイル名です。この出力は下位互換性のために提供されています。
meshy_task_idMESHY_TASK_IDMeshy API タスクの固有識別子です。
GLBFILE3DGLBGLB 形式で生成された 3D モデルです。
FBXFILE3DFBXFBX 形式で生成された 3D モデルです。