# Meshy：画像からモデルへ

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`
