> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# TencentImageToModelNode - ComfyUI Built-in Node Documentation

> Complete documentation for the TencentImageToModelNode node in ComfyUI. Learn its inputs, outputs, parameters and usage.

このノードは、TencentのHunyuan3D Pro APIを使用して、1つ以上の入力画像から3Dモデルを生成します。画像を処理し、APIに送信して、生成された3DモデルファイルをGLBおよびOBJ形式で、オプションのテクスチャマップとともに返します。

## 入力

| パラメータ                        | 説明                                                                                                    | データ型         | 必須  | 範囲                                            |
| ---------------------------- | ----------------------------------------------------------------------------------------------------- | ------------ | --- | --------------------------------------------- |
| `モデル`                        | 使用するHunyuan3Dモデルのバージョン。LowPolyオプションは`3.1`モデルでは使用できません。                                                | COMBO        | はい  | `"3.0"`<br />`"3.1"`                          |
| `画像`                         | 3Dモデルの生成に使用する主要な入力画像。128x128ピクセル以上である必要があります。                                                         | IMAGE        | はい  | -                                             |
| `左画像`                        | マルチビュー生成用のオブジェクト左側のオプション画像。128x128ピクセル以上である必要があります。                                                   | IMAGE        | いいえ | -                                             |
| `右画像`                        | マルチビュー生成用のオブジェクト右側のオプション画像。128x128ピクセル以上である必要があります。                                                   | IMAGE        | いいえ | -                                             |
| `背面画像`                       | マルチビュー生成用のオブジェクト背面のオプション画像。128x128ピクセル以上である必要があります。                                                   | IMAGE        | いいえ | -                                             |
| `面数`                         | 生成される3Dモデルの目標ポリゴン数（デフォルト：500000）。                                                                     | INT          | はい  | 3000 - 1500000                                |
| `生成タイプ`                      | 生成する3Dモデルのタイプ。オプションを選択すると、関連する追加パラメータが表示されます。                                                         | DYNAMICCOMBO | はい  | `"Normal"`<br />`"LowPoly"`<br />`"Geometry"` |
| `generate_type.pbr`          | 物理ベースレンダリング（PBR）マテリアル生成を有効にします。このパラメータは、`生成タイプ`が"Normal"または"LowPoly"に設定されている場合にのみ表示されます（デフォルト：False）。 | BOOLEAN      | いいえ | -                                             |
| `generate_type.polygon_type` | メッシュに使用するポリゴンのタイプ。このパラメータは、`生成タイプ`が"LowPoly"に設定されている場合にのみ表示されます。                                      | COMBO        | いいえ | `"triangle"`<br />`"quadrilateral"`           |
| `シード`                        | 生成プロセス用のシード値。シードはノードを再実行するかどうかを制御します。シードに関係なく結果は非決定的です（デフォルト：0）。                                      | INT          | はい  | 0 - 2147483647                                |

**注記：** すべての入力画像は、最小幅と高さが128ピクセルである必要があります。画像の最長辺が4900ピクセルを超える場合は、自動的にダウンスケールされます。

## 出力

| 出力名                  | 説明                                                     | データ型      |
| -------------------- | ------------------------------------------------------ | --------- |
| `モデルファイル`            | 下位互換性のためのレガシー出力です。                                     | STRING    |
| `GLB`                | GLB（Binary GL Transmission Format）ファイル形式で生成された3Dモデルです。 | FILE3DGLB |
| `OBJ`                | OBJ（Wavefront）ファイル形式で生成された3Dモデルです。                     | FILE3DOBJ |
| `texture_image`      | 生成された3Dモデルのテクスチャ画像です。                                  | IMAGE     |
| `optional_metallic`  | PBRマテリアル用のメタリックマップです。利用できない場合は黒画像を返します。                | IMAGE     |
| `optional_normal`    | PBRマテリアル用の法線マップです。利用できない場合は黒画像を返します。                   | IMAGE     |
| `optional_roughness` | PBRマテリアル用のラフネスマップです。利用できない場合は黒画像を返します。                 | IMAGE     |

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

***

**Source fingerprint (SHA-256):** `56ac9e55bd9bb3a5c7c46c2de1ea06921cf41c0971471f6d0b64166722705e4d`