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

# TripoP1ImageToModelNode - ComfyUI Built-in Node Documentation

> Tripo P1: Image to Model は、Tripo P1 API を使用して単一の 2D 画像を 3D モデルに変換します。

Tripo P1: Image to Model は、Tripo P1 API を使用して単一の 2D 画像を 3D モデルに変換します。低ポリゴンでゲーム向けに最適化されたメッシュの生成に適しており、ジオメトリのみのメッシュか、PBR マップ付きのテクスチャ付きモデルかを選択できます。完成したモデルは GLB ファイルとして返されます。

## 入力

### 共通入力

これらのパラメータは常に利用できます。

| パラメータ        | 説明                                                                                                                       | データ型           | 必須  | 範囲                                  |
| ------------ | ------------------------------------------------------------------------------------------------------------------------ | -------------- | --- | ----------------------------------- |
| `出力モード`      | 結果の種類を選択します。「Geometry only」は未テクスチャのメッシュを返し、「Textured」はカラー/PBR マップを追加し、追加のテクスチャ設定を表示します。                                  | DYNAMIC\_COMBO | はい  | `"Geometry only"`<br />`"Textured"` |
| `画像`         | 3D モデルの生成に使用するソース 2D 画像です。単一の画像が必要で、指定されていない場合、ノードはエラーを発生させます。                                                           | IMAGE          | はい  | -                                   |
| `画像自動補正を有効化` | 生成品質を向上させるために入力画像を前処理します。（デフォルト: False）                                                                                  | BOOLEAN        | いいえ | True<br />False                     |
| `面数制限`       | 目標フェイス数（48～20000）。-1 にすると Tripo が適応的に選択します。（デフォルト: -1）                                                                   | INT            | いいえ | -1 〜 20000                          |
| `モデルシード`     | ジオメトリ生成に使用するシードで、結果を再現できるようにします。（デフォルト: 42）                                                                              | INT            | いいえ | 0 〜 2147483647                      |
| `自動サイズ調整`    | 出力を実世界のメートルに近似するようにスケーリングします。（デフォルト: False）                                                                              | BOOLEAN        | いいえ | True<br />False                     |
| `UV展開を出力`    | 生成中に UV 展開を行います。ジオメトリのみの処理を高速化するにはオフにします。（デフォルト: True）                                                                   | BOOLEAN        | いいえ | True<br />False                     |
| `ジオメトリ圧縮`    | meshopt ジオメトリ圧縮（EXT\_meshopt\_compression）を適用します。ファイルは小さくなりますが、ComfyUI の 3D プレビューでは表示できません。編集する前に展開してください。（デフォルト: False） | BOOLEAN        | いいえ | True<br />False                     |

### ジオメトリのみの入力

追加のパラメータはありません。出力は未テクスチャのメッシュです。

### テクスチャ付き入力

これらのパラメータは、`output_mode` が「Textured」に設定されている場合に表示されます。

| パラメータ               | 説明                                                                      | データ型    | 必須 | 範囲                                              |
| ------------------- | ----------------------------------------------------------------------- | ------- | -- | ----------------------------------------------- |
| `pbr`               | PBR マップを含めます。オンの場合、ベーステクスチャも強制的にオンになります。（デフォルト: True）                   | BOOLEAN | はい | True<br />False                                 |
| `texture_quality`   | detailed = HD テクスチャ、extreme = 8K Ultra テクスチャ。（デフォルト: "standard"）        | COMBO   | はい | `"standard"`<br />`"detailed"`<br />`"extreme"` |
| `texture_alignment` | ソース画像への視覚的な忠実度を優先するか、メッシュ ジオメトリへの位置合わせを優先するか。（デフォルト: "original\_image"） | COMBO   | はい | `"original_image"`<br />`"geometry"`            |
| `orientation`       | ソース画像に一致するように出力を回転します。テクスチャ付きの場合にのみ適用されます。（デフォルト: "default"）            | COMBO   | はい | `"default"`<br />`"align_image"`                |
| `texture_seed`      | テクスチャ生成に使用するシードで、テクスチャ付きの結果を再現できるようにします。（デフォルト: 42）                     | INT     | はい | 0 〜 2147483647                                  |

注: `output_mode` が「Geometry only」の場合、リクエストではテクスチャ処理が無効になります。「Textured」モードでは、カラーテクスチャが常に要求されます。`pbr` を無効にすると PBR マップは削除されますがベースカラーテクスチャは保持され、`pbr` を有効にするとベーステクスチャも強制的にオンになります。`texture_alignment` と `orientation` は「Textured」モードでのみ利用できます。

## 出力

| 出力名             | 説明                                                          | データ型            |
| --------------- | ----------------------------------------------------------- | --------------- |
| `model_file`    | 生成されたモデルファイル名（`<task_id>.glb`）を含む文字列です。後方互換性のためにのみ保持されています。 | STRING          |
| `model task_id` | 完了した生成ジョブに対して Tripo API から返される一意のタスク ID です。                 | MODEL\_TASK\_ID |
| `GLB`           | GLB 形式で生成された 3D モデルです。                                      | FILE3DGLB       |

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

***

**Source fingerprint (SHA-256):** `1369da2ef732556896bce3415e7b99023f310544b8077ea4c6b1730bec59ee99`
