> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec-2b9c2cf.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

Hunyuan 3D 3.0 は、テンセント社が開発した最先端の 3D 生成モデルであり、数分単位での 3D コンテンツ作成を実現します。テキストプロンプト、画像、またはスケッチから、実用レベルの 3D アセットを生成可能で、従来の 3D モデリングパイプラインに比べて、はるかに低い導入ハードルを実現しています。

ComfyUI は現在、対応する Hunyuan 3D API をネイティブ統合しており、関連ノードを ComfyUI 上で簡単に利用してモデル生成を行うことができます。

現在、ComfyUI のパートナーノードは以下の Hunyuan 3D モデル生成機能をサポートしています：

* テキストから 3D への生成（Text-to-3D）
* 画像から 3D への生成（Image-to-3D）
* 複数視点画像から 3D への生成（Multi-view-to-3D）

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

## 主なユースケース

* **ゲーム開発におけるアイデア創出**：リギングおよびリアルタイムレンダリングに最適化されたトポロジーを備えた、キャラクターやプロップ、環境の高速生成
* **製品・EC（電子商取引）用途**：製品写真をインタラクティブな 3D モデルに変換し、オンライン上で表示可能に
* **工業デザイン**：スケッチから 3D プロトタイピングを実施、および 3D プリンター対応の部品分解を実行
* **VFX（視覚効果）およびアニメーション**：プロフェッショナルな UV マップおよび PBR 材質を備えた高解像度アセットの生成

## はじめに

### 1. ワークフローテンプレートへのアクセス

1. サイドバー内の「テンプレートライブラリ」を開きます
2. **3D** → **Hunyuan 3D** へとナビゲートします
3. Hunyuan 3D 用のワークフローテンプレートを選択します

### 2. ワークフローの実行

1. 使用するワークフローの種類に応じて、テキストプロンプト、画像、またはスケッチを入力します
2. `Run` ボタンをクリックするか、ショートカットキー `Ctrl（Windows）／Cmd（macOS） + Enter` を使用してモデル生成を実行します
3. ワークフローの実行が完了したら、生成された 3D モデルをプレビューおよびエクスポートできます

<h3 id="api_hunyuan3d_text_to_model">
  HunYuan3D: Text to Model
</h3>

テキストプロンプトを入力するか、参照画像をアップロードして、詳細な3Dモデルアセットを生成します。

**プロンプト例**: "Mechanical dolphin with gears, steampunk"

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_hunyuan3d_text_to_model-1.webp" alt="HunYuan3D: Text to Model ワークフローのプレビュー" />

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

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

<h3 id="api_hunyuan3d_image_to_model">
  HY 3D: Image to Model
</h3>

画像をアップロードして、ジオメトリとPBRテクスチャを持つ3Dモデルを生成します。異なる角度からのマルチビュー画像を2〜4枚アップロードすると、ジオメトリとマテリアルの忠実度が向上します。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_hunyuan3d_image_to_model-1.webp" alt="HY 3D: Image to Model ワークフローのプレビュー" />

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

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

**入力マテリアル**

これらのファイルを、対応する `LoadImage` ノードにアップロードします：

<CardGroup cols={2}>
  <Card title="pink_robot_front.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png">
    `LoadImage` ノード 1 · `pink_robot_front.png`
  </Card>

  <Card title="pink_robot_back.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_back.png">
    `LoadImage` ノード 10 · `pink_robot_back.png`
  </Card>
</CardGroup>

<div style={{display: 'grid', gridTemplateColumns: 'repeat(2, minmax(0, 1fr))', gap: '1rem', alignItems: 'start'}}>
  <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png" alt="pink_robot_front.png" style={{width: '100%', height: 'auto', objectFit: 'contain'}} />

  <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_back.png" alt="pink_robot_back.png" style={{width: '100%', height: 'auto', objectFit: 'contain'}} />
</div>

## 高度な機能

[HY 3D 3.0 の初期統合](https://blog.comfy.org/p/hunyuan-3d-30-in-comfyui-state-of)に続き、Hunyuan 3D の高度な処理機能がパートナーノード経由で利用できるようになりました。これらのワークフローは、主要な後処理ステップを ComfyUI に取り込むことで、生成とプロダクションの間のギャップを埋めるのに役立ちます。

<h3 id="api_hunyuan3d_part">
  HY 3D: 3D パーツの分解
</h3>

3D モデルをアップロードすると、自動的に構成パーツに分割され、再利用や編集に適した完全分解済みの 3D アセットが生成されます。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_hunyuan3d_part-1.webp" alt="HY 3D: 3D パーツの分解ワークフローのプレビュー" />

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

  <Card title="ワークフローをダウンロード" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_hunyuan3d_part.json">
    JSON をダウンロードするか、テンプレートライブラリで "HY 3D: 3D パーツの分解" を検索してください
  </Card>
</CardGroup>

<h3 id="api_hunyuan3d_model2uv">
  HY 3D: UV アンラッピング
</h3>

3D モデルをアップロードして UV アンラッピングを実行します。テクスチャリング用に最適化された UV レイアウトを持つ処理済みモデルを生成します。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_hunyuan3d_model2uv-1.webp" alt="HY 3D: UV アンラッピングワークフローのプレビュー" />

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

  <Card title="ワークフローをダウンロード" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_hunyuan3d_model2uv.json">
    JSON をダウンロードするか、テンプレートライブラリで "HY 3D: UV アンラッピング" を検索してください
  </Card>
</CardGroup>

<h3 id="api_hunyuan3d_smart_topology">
  HY 3D: スマートトポロジー
</h3>

高ポリゴンの 3D モデルファイルをアップロードすると、指定した削減レベルでポリゴン数が削減され、トポロジーが最適化された 3D モデルが生成されます。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_hunyuan3d_smart_topology-1.webp" alt="HY 3D: スマートトポロジーワークフローのプレビュー" />

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

  <Card title="ワークフローをダウンロード" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_hunyuan3d_smart_topology.json">
    JSON をダウンロードするか、テンプレートライブラリで "HY 3D: スマートトポロジー" を検索してください
  </Card>
</CardGroup>