# Meshy：複数画像からモデルへ

このノードは、Meshy APIを使用して複数の入力画像から3Dモデルを生成します。提供された画像をアップロードし、処理タスクを送信して、結果の3Dモデルファイル（GLBおよびFBX）をタスクIDとともに返します。

## 入力

### 共通入力

| パラメータ | 説明 | データ型 | 必須 | 範囲 |
| --- | --- | --- | --- | --- |
| `model` | 使用するAIモデルのバージョンを指定します。 | COMBO | はい | `"meshy-7.1"`<br>`"meshy-7"`<br>`"meshy-6"`<br>`"latest"` |
| `should_remesh` | 生成されたメッシュを処理するかどうかを決定します。`"false"` に設定すると、ノードは未処理の三角形メッシュを返します。`"true"` に設定すると、以下のリメッシュ設定が表示されます。 | DYNAMIC_COMBO | はい | `"true"`<br>`"false"` |
| `symmetry_mode` | 生成されたモデルに対称性を適用するかどうかを制御します。 | COMBO | はい | `"auto"`<br>`"on"`<br>`"off"` |
| `should_texture` | テクスチャを生成するかどうかを決定します。`"false"` に設定すると、テクスチャフェーズをスキップして、テクスチャのないメッシュを返します。`"true"` に設定すると、以下のテクスチャ設定が表示されます。 | DYNAMIC_COMBO | はい | `"true"`<br>`"false"` |
| `pose_mode` | 生成されたモデルのポーズモードを指定します。 | COMBO | はい | `""`（空）<br>`"A-pose"`<br>`"T-pose"` |
| `seed` | シードは、ノードを再実行するかどうかを制御します。シードに関係なく、結果は非決定的です。（デフォルト: 0） | INT | はい | 0〜2147483647 |
| `ultra_mode` | 2048³ で追加のリファインメントパスを実行し、より高忠実度で細かい表面ディテールのジオメトリを得ます。`"meshy-7.1"`、`"meshy-7"`、`"latest"` モデルが必要です（デフォルト：`False`）。 | BOOLEAN | いいえ | `True`<br>`False` |

### リメッシュ設定（`should_remesh` が `"true"` の場合に表示）

| パラメータ | 説明 | データ型 | 必須 | 範囲 |
| --- | --- | --- | --- | --- |
| `topology` | リメッシュ出力のターゲットポリゴンタイプ。 | COMBO | いいえ | `"triangle"`<br>`"quad"` |
| `target_polycount` | リメッシュモデルのターゲットポリゴン数（デフォルト: 300000）。 | INT | いいえ | 100〜300000 |

### テクスチャ設定（`should_texture` が `"true"` の場合に表示）

| パラメータ | 説明 | データ型 | 必須 | 範囲 |
| --- | --- | --- | --- | --- |
| `enable_pbr` | ベースカラーに加えて、PBRマップ（メタリック、ラフネス、ノーマル）を生成します。（デフォルト: False） | BOOLEAN | いいえ | True / False |
| `texture_prompt` | テクスチャ処理をガイドするテキストプロンプトを指定します。最大600文字です。`texture_image` と同時に使用できません。（デフォルト: 空） | STRING | いいえ | 最大600文字 |
| `texture_image` | `texture_image` と `texture_prompt` は同時に使用できません。 | IMAGE | いいえ | - |
| `texture_resolution` | ベースカラーテクスチャの解像度。高解像度ほど、より多くの表面のディテールを捉えられます。 | COMBO | いいえ | `"2k"`<br>`"4k"`<br>`"8k"` |

### 画像入力

| パラメータ | 説明 | データ型 | 必須 | 範囲 |
| --- | --- | --- | --- | --- |
| `images` | 拡張可能スロット: 2〜4枚の入力画像（`image_1`、`image_2`、`image_3`、`image_4`）を接続します。これらの画像は3Dモデルの生成に使用されます。 | IMAGE | はい | 2〜4枚 |

**注記**

* `images` 入力には2〜4枚の画像を指定する必要があります。
* `topology` と `target_polycount` パラメータは、`should_remesh` が `"true"` に設定されている場合にのみ有効です。
* `enable_pbr`、`texture_prompt`、`texture_image`、`texture_resolution` パラメータは、`should_texture` が `"true"` に設定されている場合にのみ有効です。
* `texture_prompt` と `texture_image` は相互に排他的であり、同時に使用することはできません。`texture_prompt` は600文字に制限されています。
* `seed` の値は結果を決定的にするものではなく、変更すると単にノードが生成タスクを再実行するだけです。
* `ultra_mode` には `"meshy-7.1"`、`"meshy-7"`、`"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/MeshyMultiImageToModelNode/ja.md)

---
**Source fingerprint (SHA-256):** `9475279c0990fc069b4fef2bf0e2e20218ca1a9591a261ce6d33a2b651782ddb`
