> ## 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.
# 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）
APIノードを使用するには、正しくログインしていることと、許可されたネットワーク環境で使用していることを確認する必要があります。APIノードの使用に必要な具体的な要件については、ドキュメントの「[APIノードの概要](/ja/tutorials/partner-nodes/overview)」セクションをご参照ください。
ComfyUI が最新版に更新されていることを確認してください。
* [ComfyUI のダウンロード](https://www.comfy.org/download)
* [更新手順](/ja/installation/update_comfyui)
このガイドで紹介するワークフローは、[ワークフローテンプレート](/ja/interface/features/template)から入手できます。\
テンプレート内に該当のワークフローが見つからない場合、ComfyUI のバージョンが古くなっている可能性があります。（デスクトップ版の更新は若干遅れることがあります）
ワークフローを読み込んだ際にノードが欠落している場合の主な原因：
1. 最新の ComfyUI（Nightly 版）を使用していない
2. 起動時に一部のノードのインポートに失敗している
* デスクトップ版は ComfyUI の安定版（Stable Release）をベースとしており、新しいデスクトップ安定版がリリースされると自動的に更新されます。
* [Cloud](https://cloud.comfy.org) は、ComfyUI の安定版リリース後に更新されます。
したがって、このドキュメントで記載されているコアノードのうち、一部が利用できない場合は、そのノード機能がまだ最新の安定版に含まれていないためです。次回の安定版リリースをお待ちください。
## 主なユースケース
* **ゲーム開発におけるアイデア創出**：リギングおよびリアルタイムレンダリングに最適化されたトポロジーを備えた、キャラクターやプロップ、環境の高速生成
* **製品・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 モデルをプレビューおよびエクスポートできます
## テキストから 3D へのワークフロー（Text-to-3D）
テキストによる説明を入力するだけで、ワンクリックで 3D モデルを生成します。スタイル、形状、マテリアルなどの詳細を正確に再現し、一貫性の高い結果を提供します。
**例としてのプロンプト**：「ギア付きのメカニカル・ドルフィン、ステampunk 風」
Comfy Cloud で実行
## 画像から 3D へのワークフロー（Image-to-3D）
1 枚以上の画像をアップロードすることで、高品質な 3D モデルを生成します。2～4 枚の多視点画像を入力すると、ジオメトリおよびマテリアルの忠実度が向上します。
Comfy Cloud で実行
## 複数視点画像から 3D へのワークフロー（Multi-view-to-3D）
正面・背面・側面など、複数の視点画像を提供することで、精度とディテールが向上した 3D モデルを生成します。この機能は「画像から 3D へのワークフロー」と同一のワークフローを使用しており、異なる角度から撮影した 2～4 枚の画像をアップロードするだけで利用可能です。
Comfy Cloud で実行
## 高度な機能
[初期の HY 3D 3.0 統合](https://blog.comfy.org/p/hunyuan-3d-30-in-comfyui-state-of) に続いて、Hunyuan 3D の高度な処理機能がパートナーノード経由で利用可能になりました。これらのワークフローは、重要なポストプロセッシング工程を ComfyUI 内に取り込むことで、生成から実際の制作までのギャップを埋め、実用的な制作フローを支援します。
### 3D パーツ分解
完成した 3D モデルを、装甲パーツ、アクセサリー、車輪など、意味のある構造的部品に分割します。これにより、アセットの特定領域を編集したり、バリエーション作成のために部品を交換したり、モジュラーなワークフロー、アニメーション、または下流の組立工程向けにモデルを準備することが容易になります。
ワークフローを実行
JSON ファイルを取得
### UV アンラップ
対応する 3D モデルに対して自動的に UV レイアウトを生成し、生のジオメトリをテクスチャリングが容易なアセットへと変換します。手動でシームをカットしたり UV アイランドを配置したりする必要がなく、クリーンな初期状態からペイント、ベイク、マテリアル作成といった作業へと迅速に移行できます。
ワークフローを実行
JSON ファイルを取得
### スマートトポロジー
高密度のジオメトリを、より整理されたエッジフローを持つクリーンなメッシュへと変換します。これにより、生成されたモデルを実際の制作パイプラインで最適化・再利用しやすくなります。特に、ゲームエンジンやリアルタイムレンダリング、あるいは低密度かつ構造的に優れたジオメトリを必要とするあらゆるワークフローにおいて有効です。
ワークフローを実行
JSON ファイルを取得