メインコンテンツへスキップ

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.

TripoSplat は、単一の 2D 画像から直接 3D ガウシアンスプラット（Gaussian splat） 表現を生成するオープンソースモデルです。VAST-AI によって開発され、オープンソースライセンスで公開されています。 複数視点の入力が必要だったり、主にメッシュを生成する従来の 3D 再構築手法とは異なり、TripoSplat は ガウシアンスプラット 表現を作成します。これは、数千の色付き 3D ガウシアンを空間に配置してシーンを表現するレンダリング技術で、高速で高品質なレンダリングと制御可能な密度・予算を実現します。 TripoSplat ワークフロー
ComfyUI が最新版に更新されていることを確認してください。このガイドで紹介するワークフローは、ワークフローテンプレートから入手できます。
テンプレート内に該当のワークフローが見つからない場合、ComfyUI のバージョンが古くなっている可能性があります。（デスクトップ版の更新は若干遅れることがあります）ワークフローを読み込んだ際にノードが欠落している場合の主な原因：
  1. 最新の ComfyUI（Nightly 版）を使用していない
  2. 起動時に一部のノードのインポートに失敗している

ワークフローをダウンロード

JSON をダウンロード、またはテンプレートライブラリで “TripoSplat” を検索

​
仕組み

TripoSplat は フィードフォワードアーキテクチャ を使用し、単一の RGB 画像を受け取って 3D ガウシアンプリミティブのセットを直接予測します。パイプラインの流れ：
  1. 画像エンコード — 入力画像がビジョンエンコーダー（DINOv2）で処理される
  2. トライプレーン生成 — 特徴がトライプレーン表現にデコードされる
  3. ガウシアン予測 — トライプレーンをサンプリングしてガウシアンパラメータ（位置、スケール、回転、不透明度、色）を生成
  4. レンダリング — 微分可能なスプラッティングを使用して任意の視点からガウシアンをレンダリング

サブグラフについて

このワークフローはサブグラフノードを使用してモジュール化された処理を行います。サブグラフのドキュメントを参照して、ワークフローをカスタマイズおよび拡張する方法を学んでください。

​
ワークフローノードガイド

​
LoadImage

  • 入力画像を読み込みます（PNG/JPG）
  • サンプル画像：white-hotel-on-rocky-island.png（テンプレートライブラリから入手可能）

​
TripoSplat（サブグラフ）

画像を処理して 3D ガウシアンスプラットを生成するメインのサブグラフノード。公開パラメータ：
パラメータデフォルト説明
switch—サブグラフの有効/無効
num_gaussians—生成するガウシアンプリミティブの数（品質/パフォーマンス制御）
seed—再現性のためのシード値
unet_name—TripoSplat 拡散モデルチェックポイント
clip_name—CLIP ビジョンエンコーダーモデル
vae_name—エンコード/デコード用の VAE（2つ：メイン VAE とエンコーダー）
bg_removal_name—背景除去モデル

​
CreateCameraInfo

  • 結果をレンダリングするカメラ軌道を定義
  • パラメータ：軌道タイプ、角度、距離、視野など
  • デフォルト：仰角 35°、距離 30、ズーム 2.5

​
RenderSplat

  • 定義されたカメラ角度からガウシアンスプラットを 2D 画像にレンダリング
  • パラメータ：出力解像度（デフォルト 1024×1024）、画質設定

​
SplatToMesh

  • ガウシアンスプラットをメッシュに変換（オプション）
  • パラメータ：メッシュ密度、スムージング、簡略化

​
SaveGLB

  • 結果を GLB 3D ファイルとして保存

​
SaveVideo

  • レンダリングされた 3D シーンの動画を保存

​
SplatToFile3D

  • ガウシアンスプラットを SPZ 形式でエクスポート

​
CreateVideo

  • レンダリングフレームから動画を作成

​
実行手順

  1. 画像を読み込む — LoadImage ノードで単一の 2D 画像を読み込みます
  2. TripoSplat サブグラフを実行 — モデルがガウシアンスプラット表現を生成します
  3. 出力形式を選択 — GLB、SPZ、動画、またはメッシュに変換
  4. 結果を表示 — 生成された 3D ファイルまたはレンダリングプレビューを確認

​
出力オプション

ノード形式用途
SaveGLB.glb標準的な 3D ファイル形式。3D ソフトウェアにインポート可能
SplatToFile3D.spz圧縮されたガウシアンスプラット形式。効率的な保存
RenderSplat2D 画像任意の角度から結果を素早くプレビュー
SplatToMeshメッシュ従来のメッシュに変換してさらに編集

​
モデルダウンロード

TripoSplat モデルと必要なファイルをダウンロードします。対応する models/ サブディレクトリに配置してください。

TripoSplat 拡散モデル

triposplat_fp16.safetensors — TripoSplat 拡散モデルチェックポイント

TripoSplat VAE デコーダー

triposplat_vae_decoder_fp16.safetensors — VAE デコーダー

Flux2 VAE

flux2-vae.safetensors — Flux.2 VAE、潜在表現エンコード用

DINOv2 CLIP

dino_v3_vit_h.safetensors — CLIP ビジョンエンコーダー（DINOv2）

BiRefNet 背景除去

birefnet.safetensors — 前処理用の背景除去モデル

​
モデル保存場所

📂 ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │      └── triposplat_fp16.safetensors
│   ├── 📂 vae/
│   │      ├── triposplat_vae_decoder_fp16.safetensors
│   │      └── flux2-vae.safetensors
│   ├── 📂 clip_vision/
│   │      └── dino_v3_vit_h.safetensors
│   └── 📂 background_removal/
│          └── birefnet.safetensors