> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-custom-nodes-sdk-v2-frontend.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"`<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        | はい    | -                                            |

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

* `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` には `"meshy-7"` または `"latest"` モデルが必要です。`"meshy-6"` モデルで `ultra_mode` が有効な場合、ノードはエラーを発生させます。

## 出力

| 出力名             | 説明                                          | データ型            |
| --------------- | ------------------------------------------- | --------------- |
| `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):** `689828ad52de4493e1039aecc408e18af4122d2c0e2511fd254ba0f1d56bad14`