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

# Tripo API ノードによるモデル生成：ComfyUI 公式サンプル

> 本記事では、ComfyUI 内で Tripo ノードの API を使用して 3D モデルを生成する方法について説明します

Tripo AI は、生成AIを活用した3Dモデリングに特化した企業です。ユーザーが直感的に操作できるプラットフォームおよびAPIサービスを提供しており、テキストプロンプトや2D画像（単一または複数）を高速かつ高品質な3Dモデルへと変換できます。\
ComfyUI は現在、Tripo の API をネイティブ統合済みであり、関連ノードを簡単に利用してモデル生成を行うことが可能です。

現時点において、ComfyUI のパートナーノードは以下の Tripo モデル生成機能をサポートしています：

* テキストからモデル生成（Text-to-Model）
* 画像からモデル生成（Image-to-Model）
* 複数視点からのモデル生成（Multi-view Model Generation）
* リグ付きモデル生成（Rig Model）
* リグ付きモデルのリターゲティング（Retarget Rigged Model）

<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="デスクトップ版またはクラウド版ユーザー">
      * デスクトップ版は ComfyUI の安定版（Stable Release）をベースとしており、新しいデスクトップ安定版がリリースされると自動的に更新されます。
      * [Cloud](https://cloud.comfy.org) は、ComfyUI の安定版リリース後に更新されます。

      したがって、このドキュメントで記載されているコアノードのうち、一部が利用できない場合は、そのノード機能がまだ最新の安定版に含まれていないためです。次回の安定版リリースをお待ちください。
    </Tab>
  </Tabs>
</Tip>

## テキストからモデル生成（Text-to-Model）ワークフロー

### 1. ワークフローファイルのダウンロード

以下のファイルをダウンロードし、ComfyUI へドラッグ＆ドロップすることで、対応するワークフローを読み込めます。

<a className="prose" target="_blank" href="https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/api_nodes/tripo/api_tripo_text_to_model.json" style={{ display: 'inline-block', backgroundColor: '#0078D6', color: '#ffffff', padding: '10px 20px', borderRadius: '8px', borderColor: "transparent", textDecoration: 'none', fontWeight: 'bold'}}>
  <p className="prose" style={{ margin: 0, fontSize: "0.8rem" }}>JSON形式ワークフローファイルをダウンロード</p>
</a>

### 2. ワークフロー実行手順（ステップ・バイ・ステップ）

<img src="https://mintcdn.com/dripart-mintlify-b90d3c69/bdlNbcBi2aXaN46h/images/tutorial/api_nodes/tripo/tripo_text_to_model_step_guide.jpg?fit=max&auto=format&n=bdlNbcBi2aXaN46h&q=85&s=6e0c9c6a55ce13a7522144d66d22d6fa" alt="ComfyUI Tripo Text to Model Step Guide" width="2318" height="1564" data-path="images/tutorial/api_nodes/tripo/tripo_text_to_model_step_guide.jpg" />

上記画像中の番号を参考に、基本的なテキストからモデル生成のワークフローを実行してください：

1. `Tripo: Text to Model` ノードの `prompt` フィールドにプロンプトを入力します
   * **model**：異なるモデルを選択可能ですが、現時点で `Tripo: Refine Draft model` による後続最適化をサポートするのは v1.4 モデルのみです
   * **style**：さまざまなスタイルを設定できます
   * **texture\_quality**：さまざまなテクスチャ品質を設定できます
2. `Run` ボタンをクリックするか、ショートカットキー `Ctrl（macOSではCmd） + Enter` を押してモデル生成を実行します。ワークフロー完了後、対応するモデルは自動的に `ComfyUI/output/` ディレクトリへ保存されます
3. `Preview 3D` ノードをクリックしてメニューを展開します
4. `Export` を選択すると、対応するモデルを直接エクスポートできます

## 画像からモデル生成（Image-to-Model）ワークフロー

### 1. ワークフローファイルのダウンロード

以下のファイルをダウンロードし、ComfyUI へドラッグ＆ドロップすることで、対応するワークフローを読み込めます。

<a className="prose" target="_blank" href="https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/api_nodes/tripo/image_to_model/api_tripo_image_to_model.json" style={{ display: 'inline-block', backgroundColor: '#0078D6', color: '#ffffff', padding: '10px 20px', borderRadius: '8px', borderColor: "transparent", textDecoration: 'none', fontWeight: 'bold'}}>
  <p className="prose" style={{ margin: 0, fontSize: "0.8rem" }}>JSON形式ワークフローファイルをダウンロード</p>
</a>

以下の画像を入力画像としてダウンロードしてください：

![入力画像](https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/api_nodes/tripo/image_to_model/panda.jpg)

### 2. ワークフロー実行手順（ステップ・バイ・ステップ）

<img src="https://mintcdn.com/dripart-mintlify-b90d3c69/bdlNbcBi2aXaN46h/images/tutorial/api_nodes/tripo/tripo_image_to_model_step_guide.jpg?fit=max&auto=format&n=bdlNbcBi2aXaN46h&q=85&s=3ebc7b9bed0474dc0eeff416a3cbf85b" alt="ComfyUI Tripo Text to Model Step Guide" width="2242" height="2610" data-path="images/tutorial/api_nodes/tripo/tripo_image_to_model_step_guide.jpg" />

上記画像中の番号を参考に、基本的な画像からモデル生成のワークフローを実行してください：

1. `Load Image` ノードで、提供された入力画像を読み込みます
2. `Tripo: Image to Model` ノードで、対応するパラメータ設定を変更します
   * **model**：異なるモデルを選択可能ですが、現時点で `Tripo: Refine Draft model` による後続最適化をサポートするのは v1.4 モデルのみです
   * **style**：さまざまなスタイルを設定できます
   * **texture\_quality**：さまざまなテクスチャ品質を設定できます
3. `Run` ボタンをクリックするか、ショートカットキー `Ctrl（macOSではCmd） + Enter` を押してモデル生成を実行します。ワークフロー完了後、対応するモデルは自動的に `ComfyUI/output/` ディレクトリへ保存されます
4. モデルのダウンロードについては、「テキストからモデル生成」セクションの手順をご参照ください

## 複数視点からのモデル生成（Multi-view Model Generation）ワークフロー

### 1. ワークフローファイルのダウンロード

以下のファイルをダウンロードし、ComfyUI へドラッグ＆ドロップすることで、対応するワークフローを読み込めます。

<a className="prose" target="_blank" href="https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/api_nodes/tripo/multiview_to_image/api_tripo_multiview_to_model.json" style={{ display: 'inline-block', backgroundColor: '#0078D6', color: '#ffffff', padding: '10px 20px', borderRadius: '8px', borderColor: "transparent", textDecoration: 'none', fontWeight: 'bold'}}>
  <p className="prose" style={{ margin: 0, fontSize: "0.8rem" }}>JSON形式ワークフローファイルをダウンロード</p>
</a>

以下の画像を入力画像としてダウンロードしてください：

![正面図](https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/api_nodes/tripo/multiview_to_image/front.jpg)
![背面図](https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/api_nodes/tripo/multiview_to_image/back.jpg)

### 2. ワークフロー実行手順（ステップ・バイ・ステップ）

<img src="https://mintcdn.com/dripart-mintlify-b90d3c69/bdlNbcBi2aXaN46h/images/tutorial/api_nodes/tripo/tripo_multiview_to_model_step_guide.jpg?fit=max&auto=format&n=bdlNbcBi2aXaN46h&q=85&s=1ba66882413eb75a18dccc988518dabe" alt="ComfyUI Tripo Text to Model Step Guide" width="4474" height="2210" data-path="images/tutorial/api_nodes/tripo/tripo_multiview_to_model_step_guide.jpg" />

上記画像中の番号を参考に、基本的な複数視点からモデル生成のワークフローを実行してください：

1. `Load Image` ノードで、提供された各入力画像をそれぞれ読み込みます
2. `Tripo: Image to Model` ノードで、対応するパラメータ設定を変更します
   * **model**：異なるモデルを選択可能ですが、現時点で `Tripo: Refine Draft model` による後続最適化をサポートするのは v1.4 モデルのみです
   * **style**：さまざまなスタイルを設定できます
   * **texture\_quality**：さまざまなテクスチャ品質を設定できます
3. `Run` ボタンをクリックするか、ショートカットキー `Ctrl（macOSではCmd） + Enter` を押してモデル生成を実行します。ワークフロー完了後、対応するモデルは自動的に `ComfyUI/output/` ディレクトリへ保存されます
4. その他の視点画像を入力する場合、手順図を参考に、対応するノードのモードを `Always` に設定して有効化してください
5. モデルのダウンロードについては、「テキストからモデル生成」セクションの手順をご参照ください

## 同一タスクに対する後続処理

Tripo の対応ノードでは、同一タスクに対する後続処理も提供されています。関連ノードに該当する `model_task_id` を入力するだけで利用可能です。また、関連テンプレートにはすでに該当ノードが用意されており、必要に応じて対応するノードのモードを変更して有効化することもできます。

<img src="https://mintcdn.com/dripart-mintlify-b90d3c69/bdlNbcBi2aXaN46h/images/tutorial/api_nodes/tripo/other_nodes.jpg?fit=max&auto=format&n=bdlNbcBi2aXaN46h&q=85&s=8b2bcd02b37f15305c7d2c1bd04cba0a" alt="Tripo タスク処理" width="904" height="696" data-path="images/tutorial/api_nodes/tripo/other_nodes.jpg" />

<Error>
  `Tripo: Refine Draft model` ノードは v1.4 モデルのみをサポートしており、他のモデルでは利用できません
</Error>