> ## 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.

# Tripo P2: ComfyUIでのクアッドトポロジー3Dモデル生成

> ComfyUIのTripo P2パートナーノードで実運用可能な3Dモデルを生成: ネイティブなクアッドトポロジー、最大50,000フェイスのポリゴン数、2Kから8Kまでのテクスチャレベルに対応。

Tripo P2 は、ネイティブなクアッドトポロジーのメッシュを出力する Tripo の P シリーズ 3D 生成モデルです。従来の text-to-3D や image-to-3D モデルが三角形メッシュを返すのに対し、Tripo P2 は四角形の面からジオメトリを構築し、関節周りにはクリーンなエッジループ、平坦な面には均一な密度を実現します。クアッドはリグ下で予測可能に変形し、きれいに細分割でき、ゲーム、映画、製品ビジュアライゼーションにおけるリトポロジー中心のパイプラインの標準的な入力となります。

Tripo P2 は 3 つの入力モードをサポートしています。テキストからモデル、単一画像からモデル、マルチビューからモデル（正面、左、背面、右のリファレンス）です。メッシュの上限は 50,000 三角形、クアッドモードでは 25,000 クアッドに達します。テクスチャ出力は段階的で、スタンダードは 2K、詳細は 4K、エクストリームは 8K です。ベース色に加えて PBR マップ（メタリック、ラフネス、ノーマル）も利用できます。

ComfyUI では、P2 ノードは他の Tripo パートナーノードと同様に動作します。ノードを追加して入力を指定すると、ワークフローがテクスチャリング、リギング、変換、エクスポートを自動的に処理します。ローカル GPU やモデルのダウンロードは不要です。

<Tip>
  APIノードを使用するには、正しくログインしていることと、許可されたネットワーク環境で使用していることを確認する必要があります。APIノードの使用に必要な具体的な要件については、ドキュメントの「[APIノードの概要](/ja/tutorials/partner-nodes/overview)」セクションをご参照ください。
</Tip>

<Tip>
  <Tabs>
    <Tab title="ローカルユーザー">
      ComfyUI が最新版に更新されていることを確認してください。

      * [ComfyUI のダウンロード](https://www.comfy.org/download)
      * [更新手順](/ja/installation/update_comfyui)

      このガイドで紹介するワークフローは、[ワークフローテンプレート](/ja/interface/features/template)から入手できます。
      テンプレート内に該当のワークフローが見つからない場合、ComfyUI のバージョンが古くなっている可能性があります。

      ワークフローを読み込んだ際にノードが欠落している場合の考えられる原因：

      1. 最新の ComfyUI（Nightly 版）を使用していない
      2. 起動時に一部のノードのインポートに失敗している
    </Tab>

    <Tab title="クラウドユーザー">
      * [Cloud](https://cloud.comfy.org) は、ComfyUI の安定版リリース後に更新されます。

      したがって、このドキュメントでコアノードが見つからない場合、それは新しいコアノードがまだ最新の安定版にリリースされていない可能性があります。次回の安定版リリースをお待ちください。
    </Tab>
  </Tabs>
</Tip>

## Tripo P2 が得意なこと

* **ネイティブなクアッドトポロジー**: クリーンなエッジフローを持つクアッドメッシュで、手動リトポロジーなしでリギングやアニメーションにすぐ使えます
* **大きなメッシュのポリゴン数**: 48～50,000三角形、クアッドモードでは48～25,000クアッド
* **段階的テクスチャリング**: スタンダード（2K）、詳細（4K）、エクストリーム（8K）のベースカラーテクスチャと、オプションのPBRマップ
* **3つの入力モード**: テキストプロンプト、単一の参照画像、または最大4枚のマルチビュー画像（正面、左、背面、右）

料金は選択済みのテクスチャレベルによって異なります。詳細は[料金](/ja/tutorials/partner-nodes/pricing)をご覧ください。

## Tripo P2: テキストからモデル

テキストの説明から3Dモデルを生成します。Tripo P2 はまずプロンプトからコンセプト画像を描画し（`image_seed` で制御）、その画像からジオメトリをモデリングします。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_tripo_p2_text_to_model-1.webp" alt="Tripo P2 Text to Model Workflow" />

<CardGroup cols={2}>
  <Card title="Comfy Cloud で実行" icon="cloud" href="https://cloud.comfy.org/?template=api_tripo_p2_text_to_model&utm_source=docs&utm_medium=referral&utm_campaign=tripo_p2_t2m">
    Comfy Cloud で開く
  </Card>

  <Card title="ワークフローをダウンロード" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_tripo_p2_text_to_model.json">
    JSON をダウンロードするか、テンプレートライブラリで「Tripo P2: Text to Model」を検索してください
  </Card>
</CardGroup>

### 実行手順

1. **プロンプトを入力**: **Tripo P2: Text to Model** ノードに3Dモデルの説明を記入します（最大1024文字）。ネガティブプロンプトは高度なオプションで利用できます
2. **テクスチャレベルを選択**: `standard`（2K）、`detailed`（4K）、`extreme`（8K）、またはテクスチャなしのメッシュにする場合は `none`
3. **quad 出力を切り替え**: `quad` を有効にするとメッシュは FBX として返され、無効にすると GLB として返されます
4. **面の上限を設定**: 目標面数は48～50,000（quad 使用時は48～25,000）の範囲で指定するか、-1 のままにして Tripo に任せます
5. **キューをクリック**: `Ctrl+Enter` を押して生成します

生成後、ワークフローは自動的にモデルにテクスチャを適用し（**TripoTextureNodeV2**）、リギングを行い（**TripoRigNode**）、プリセットアニメーションを適用し（**TripoRetargetNode**）、結果を変換して（**TripoConversionNode**）から保存します。

### quad 出力に関する注意

`quad` が有効な場合は、**Save 3D** を FBX 出力スロットに接続します。`quad` が無効な場合は、GLB 出力スロットを使用します。

## Tripo P2: 画像からモデル

1枚の参照画像から3Dモデルを生成します。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_tripo_p2_image_to_model-1.webp" alt="Tripo P2 Image to Model Workflow" />

<CardGroup cols={2}>
  <Card title="Comfy Cloudで実行" icon="cloud" href="https://cloud.comfy.org/?template=api_tripo_p2_image_to_model&utm_source=docs&utm_medium=referral&utm_campaign=tripo_p2_i2m">
    Comfy Cloudで開く
  </Card>

  <Card title="ワークフローをダウンロード" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_tripo_p2_image_to_model.json">
    JSONをダウンロード、またはテンプレートライブラリで「Tripo P2: Image to Model」を検索
  </Card>
</CardGroup>

### 実行手順

1. **参照画像をアップロード**: **LoadImage** ノードで被写体の正面画像を読み込みます
2. **テクスチャレベルを選択**: `standard`、`detailed`、`extreme`、または `none`
3. **クアッド出力を切り替え**: 有効時はFBX、無効時はGLB
4. **テクスチャの位置合わせを設定**: `original_image` は入力画像の色に一致させ、`geometry` は生成された形状にテクスチャを合わせます (高度な機能)
5. **キューをクリック**: `Ctrl+Enter` を押して生成します

### 入力のヒント

* 低解像度または低品質の画像は、`enable_image_autofix` 高度な機能を使ってモデリング前に補正できます
* `align_image` の向きは、入力画像の視点にモデルを回転させます (高度な機能)

## Tripo P2: マルチビューからモデルを生成

マルチビューノードは最大4枚の画像を受け付けます。必須の正面ビューに加えて、オプションで左、背面、右のビューを指定できます。このノードは、ノードライブラリの同じ **Tripo P2** ノードファミリーで利用できます。参照画像を各ビュースロットに接続し、上記と同じテクスチャとクアッドのオプションに従ってください。

## ノードオプションリファレンス

3 つの P2 ノードすべてで共通のオプション:

| オプション        | 値                                    | デフォルト    | 備考                                               |
| ------------ | ------------------------------------ | -------- | ------------------------------------------------ |
| `quad`       | on / off                             | off      | オンのときはクアッドメッシュを FBX で、オフのときはトライアングルメッシュを GLB で出力 |
| `face_limit` | 48 ～ 50,000（quad 使用時は 25,000）        | -1       | 目標フェイス数。結果がこの値を超えることもある                          |
| `texture`    | standard / detailed / extreme / none | standard | 2K / 4K / 8K のベースカラー。none はテクスチャなしのメッシュを返す       |
| `pbr`        | on / off                             | on       | メタリック、ラフネス、ノーマルマップ。texture が none のときは無視される      |
| `model_seed` | 0 ～ 2147483647                       | 42       | ジオメトリのシード                                        |

高度な機能には `texture_seed`、`auto_size`（メートル単位の実世界スケール）、`export_uv`、`compress_geometry`（Meshopt 圧縮。圧縮されたメッシュは大幅に小さくなりますが、ComfyUI の 3D ビューポートではプレビューできません）があります。
