> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MeshyImageToModelNode - ComfyUI Built-in Node Documentation

> Meshy: Image to Model ノードは、Meshy API を使用して、1枚の入力画像から3Dモデルを生成します。

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

## 入力

| パラメータ | 説明 | データ型 | 必須 | 範囲 |
| - | - | - | - | - |
| `model` | 生成に使用するAIモデルのバージョンを指定します。 | COMBO | はい | `"meshy-7.1"`<br />`"meshy-7"`<br />`"meshy-6"`<br />`"latest"` |
| `image` | 3Dモデルに変換する入力画像です。 | IMAGE | はい | - |
| `should_remesh` | `"false"` に設定すると、未処理の三角形メッシュを返します。 | DYNAMIC\_COMBO | はい | `"true"`<br />`"false"` |
| `topology` | リメッシュ後のモデルのターゲットとなるポリゴントポロジーです。この入力は、`should_remesh` が `"true"` に設定されている場合にのみ使用できます。 | COMBO | いいえ\* | `"triangle"`<br />`"quad"` |
| `target_polycount` | リメッシュ後のモデルのターゲットとなるポリゴン数です。この入力は、`should_remesh` が `"true"` に設定されている場合にのみ使用できます。デフォルト: 300000。 | INT | いいえ\* | 100 - 300000 |
| `symmetry_mode` | 生成された3Dモデルに適用する対称性を制御します。 | COMBO | はい | `"auto"`<br />`"on"`<br />`"off"` |
| `should_texture` | テクスチャを生成するかどうかを決定します。`"false"` に設定すると、テクスチャフェーズをスキップして、テクスチャのないメッシュを返します。 | DYNAMIC\_COMBO | はい | `"true"`<br />`"false"` |
| `enable_pbr` | ベースカラーに加えてPBRマップ（メタリック、ラフネス、ノーマル）を生成します。この入力は、`should_texture` が `"true"` に設定されている場合にのみ使用できます。デフォルト: `False`。 | BOOLEAN | いいえ\* | - |
| `texture_prompt` | テクスチャ処理をガイドするテキストプロンプトを指定します。最大600文字です。`texture_image` と同時に使用することはできません。この入力は、`should_texture` が `"true"` に設定されている場合にのみ使用できます。デフォルト: 空文字列。 | STRING | いいえ\* | - |
| `texture_image` | `texture_image` または `texture_prompt` は、同時にはどちらか一方のみ使用できます。この入力は、`should_texture` が `"true"` に設定されている場合にのみ使用できます。 | IMAGE | いいえ\* | - |
| `texture_resolution` | ベースカラーテクスチャの解像度です。解像度が高いほど、より詳細な表面をキャプチャできます。この入力は、`should_texture` が `"true"` に設定されている場合にのみ使用できます。 | COMBO | いいえ\* | `"2k"`<br />`"4k"`<br />`"8k"` |
| `pose_mode` | 生成されたモデルのポーズモードを指定します。これは高度なパラメータです。 | COMBO | はい | `""` (空)<br />`"A-pose"`<br />`"T-pose"` |
| `seed` | シードはノードを再実行するかどうかを制御します。シードに関係なく結果は非決定的です。デフォルト: 0。 | INT | はい | 0 - 2147483647 |
| `ultra_mode` | より細かい表面ディテールを持つ、忠実度の高いジオメトリを得るために、追加のリファインメントパスを実行します。デフォルト: `False`。 | BOOLEAN | はい | - |
| `ultra_resolution` | ウルトラパスの解像度：`"2k"` は 2048³、`"4k"` は 4096³ で実行され、最も細かい表面ディテールが得られます。`"4k"` には `"meshy-7.1"` または `"latest"` モデルが必要です。`ultra_mode` が有効な場合にのみ使用されます（デフォルト：`"2k"`）。 | COMBO | いいえ | `"2k"`<br />`"4k"` |

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

* `topology` と `target_polycount` の入力は、`should_remesh` が `"true"` に設定されている場合にのみ使用できます。
* `enable_pbr`、`texture_prompt`、`texture_image`、`texture_resolution` の入力は、`should_texture` が `"true"` に設定されている場合にのみ使用できます。
* `should_texture` が `"true"` に設定されている場合、`texture_prompt` と `texture_image` を同時に使用することはできません。両方が指定された場合、ノードはエラーを発生させます。
* `texture_prompt` は最大600文字です。
* `ultra_mode` が有効な場合、`model` パラメータは `"meshy-7.1"`、`"meshy-7"`、`"latest"` のいずれかに設定する必要があります。それ以外のモデルを選択するとエラーになります。`"meshy-7"` ではウルトラパスは常に 2048³ で実行され、`"4k"` の解像度には `"meshy-7.1"` または `"latest"` が必要です。

## 出力

| 出力名 | 説明 | データ型 |
| - | - | - |
| `model_file` | 生成されたGLBモデルのファイル名です。後方互換性のためだけに維持されています。 | STRING |
| `meshy_task_id` | Meshy APIタスクの一意の識別子で、参照やトラブルシューティングに使用できます。 | MESHY\_TASK\_ID |
| `GLB` | GLBファイル形式で生成された3Dモデルです。 | FILE3DGLB |
| `FBX` | FBXファイル形式で生成された3Dモデルです。 | FILE3DFBX |

> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください！ [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshyImageToModelNode/ja.md)

***

**Source fingerprint (SHA-256):** `38528b48c3f792a459008a52f65fae248ef1dadafb37fe4dc6b697d25bc89f4f`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.