Tripo3D

ComfyUI Düğümleri

ComfyUI Düğümleri

ComfyUI-Tripo, Tripo’nun ComfyUI için resmi özel düğüm eklentisidir. Metin, görüntü veya çoklu görünümden 3D üretimini ComfyUI iş akışlarına taşır; ayrıca model içe aktarma, dokulama, iyileştirme, ağ işleme, düşük poligon optimizasyonu, stilizasyon, rigleme, animasyon yeniden hedefleme, biçim dönüştürme ve retopolojiyi destekler.

Öğe Değer
Node proje sürümü 1.3.0
Kaynak etiketi v1.3.1.1
Depo VAST-AI-Research/ComfyUI-Tripo

Özellikler ve değişiklik günlüğü

Özellikler

  • Metinden 3B model oluşturma.
  • Görüntülerden 3B model oluşturma.
  • model_url ile URL’den model içe aktarma.
  • Model parçalarını ayırmayı destekler.
  • 3B modelleri rigleme ve animasyon uygulama.
  • Format dönüştürme ve retopoloji.

Değişiklik günlüğü

  • 2026-06-30: modelleri parçalara ayırmak için Mesh Segmentation v2.0 ve model_url ile doğrudan URL içe aktarma eklendi.
  • 2026-05-28: model içe aktarma eklendi.
  • 2025-06-19: en yeni API’ye geçildi ve yeni düğümler eklendi.
  • 2025-03-31: tripo3d paketine geçildi.
  • 2025-02-24: glbviewer kaldırıldı.
  • 2025-02-01: yeni API’ye uyum sağlandı ve model görüntüleme Preview 3D’ye taşındı.
  • 2024-11-11: yeni API’ye uyum sağlandı.
  • 2024-10-14: model dönüştürme eklendi.
  • 2024-09-13: model_version v2.0-20240919 desteği eklendi.

Kurulum

Resmî araçlar: ComfyUI-Manager, Comfy Registry ve comfy-cli.

Bir yöntem seçin ve ardından ComfyUI’yi yeniden başlatın.

  1. ComfyUI-Manager: Custom Nodes Manager içinde Tripo for ComfyUI arayıp kurun.
  2. comfy-cli:
Bash
comfy node registry-install comfyui-tripo
  1. Kaynaktan:
Bash
cd ComfyUI/custom_nodes
git clone https://github.com/VAST-AI-Research/ComfyUI-Tripo.git
python -m pip install -r ComfyUI-Tripo/requirements.txt

API Key yapılandırması

Önce Tripo platformunda bir API Key oluşturun, ardından aşağıdaki yöntemlerden biriyle yapılandırın.

Anahtar şu sırayla çözümlenir:

  1. Düğümde boş olmayan apikey girdisi.
  2. TRIPO_API_KEY ortam değişkeni.
  3. Proje dizinindeki config.json dosyasının TRIPO_API_KEY alanı.

Generate ve Import apikey sunar; sonraki düğümler çözümlenen anahtarı MODEL_INFO ile alır. Gerçek anahtarı ekran görüntülerinde, workflow dosyalarında, loglarda veya depolarda paylaşmayın.

Ortam değişkeniyle başlatma örnekleri

Windows:

Shell
set TRIPO_API_KEY=tsk_XXXXXXX
python.exe main.py [--cpu]

Linux veya macOS:

Bash
TRIPO_API_KEY=tsk_XXXXXXX python main.py [--cpu]

Düğüm özeti

ComfyUI-Tripo aşağıdaki 11 Tripo düğümünü sunar:

Dahili ID Arayüz adı Yetenek Çıktı
TripoAPIDraft Tripo: Generate model Metin, görsel veya çoklu görünümden model üretir. STRING model_file + MODEL_INFO
TripoImportModel Tripo: Import model Yerel model veya URL içe aktarır. MODEL_INFO
TripoTextureModel Tripo: Texture model Modele doku uygular. STRING model_file + MODEL_INFO
TripoRefineModel Tripo: Refine Draft model Uyumlu taslağı iyileştirir. STRING model_file + MODEL_INFO
TripoMeshSegmentation Tripo: Segment mesh Mesh segmentasyonu yapar. STRING model_file + MODEL_INFO
TripoMeshCompletion Tripo: Complete mesh Segmentli mesh’i tamamlar. STRING model_file + MODEL_INFO
TripoSmartLowPoly Tripo: Smart low poly Low-poly model oluşturur. STRING model_file + MODEL_INFO
TripoStylizeModel Tripo: Stylize model Geometrik stil uygular. STRING model_file + MODEL_INFO
TripoAnimateRigNode Tripo: Rig model Otomatik rig uygular. STRING model_file + MODEL_INFO
TripoAnimateRetargetNode Tripo: Retarget rigged model Hazır animasyon uygular. STRING model_file + MODEL_INFO
TripoConvertNode Tripo: Convert model Modeli dönüştürür ve dışa aktarır. STRING model_file

Preview 3D, ComfyUI tarafından sağlanır ve 11 Tripo düğümüne dahil değildir.

Bağlantılar ve veri akışı

flowchart LR
    G["Generate model"] -->|MODEL_INFO| P["Model işleme"]
    I["Import model"] -->|MODEL_INFO| P
    P -->|MODEL_INFO| R["Rig model"]
    R -->|MODEL_INFO| A["Retarget rigged model"]
    A -->|MODEL_INFO| C["Convert model"]
  • model_file, önizleme veya dosya işlemleri için indirilen dosya yoludur.
  • MODEL_INFO, task_id, çözümlenen apikey, file_prefix ve output_directory içerir.
  • Harici model önce TripoImportModel üzerinden geçmelidir; dosya yolu MODEL_INFO yerine geçmez.
  • Tripo işlemine devam etmek için MODEL_INFO bağlayın.

Tam düğüm referansı

“Zorunlu”, düğüm tanımında gerekli olan girişleri belirtir. Boş apikey, ortam veya yapılandırmaya dönebilir. Tire, açık bir varsayılan değer tanımlanmadığını gösterir.

Üretim ve içe aktarma

TripoAPIDraft — Tripo: Generate model

Metin, görsel veya çoklu görünümden model üretir.

Girdi Tür Zorunlu Varsayılan Değerler / aralık
mode ENUM Evet ilk değer text_to_model, image_to_model, multiview_to_model
apikey STRING Evet boş API key veya geri dönüş
prompt STRING multiline Hayır boş text_to_model
negative_prompt STRING multiline Hayır boş —
image IMAGE Hayır — image_to_model kaynak; multiview_to_model ön görünüm
image_left IMAGE Hayır — multiview_to_model
image_back IMAGE Hayır — multiview_to_model
image_right IMAGE Hayır — multiview_to_model
model_version ENUM Hayır v3.1-20260211 v1.4-20240625, v2.0-20240919, v2.5-20250123, v3.0-20250812, v3.1-20260211
texture BOOLEAN Hayır true —
pbr BOOLEAN Hayır true —
image_seed INT Hayır 42 text_to_model
model_seed INT Hayır 42 —
texture_seed INT Hayır 42 —
texture_quality ENUM Hayır standard standard, detailed
geometry_quality ENUM Hayır standard standard, detailed; image_to_model
texture_alignment ENUM Hayır original_image original_image, geometry
face_limit INT Hayır -1 -1–500000; ≤ 0 ayarlanmamış sayılır
quad BOOLEAN Hayır false —
compress BOOLEAN Hayır false —
generate_parts BOOLEAN Hayır false —
smart_low_poly BOOLEAN Hayır false —
auto_size BOOLEAN Hayır false —
orientation ENUM Hayır default default, align_image; görsel/multiview modları
file_prefix STRING Hayır boş —
output_directory STRING Hayır boş —

Çıktı: STRING model_file + MODEL_INFO. Önkoşul: yok. Yaygın hatalar: koşullu girdi/anahtar eksik, API görevi veya çıktı taşıma hatası. En küçük bağlantı: Metin/görsel → TripoAPIDraft → Preview 3D.

Üç modun koşullu zorunlu girdileri:

mode Moda göre zorunlu Not
text_to_model prompt prompt boş olamaz.
image_to_model image image zorunludur.
multiview_to_model image image ön görünümdür; sol, arka ve sağ isteğe bağlıdır.

TripoImportModel — Tripo: Import model

Yerel model veya URL içe aktarır.

Girdi Tür Zorunlu Varsayılan Değerler / aralık
apikey STRING Evet boş API key veya geri dönüş
model_file file selector Hayır none ComfyUI input dizini
model_url STRING Hayır boş doğrudan URL
file_prefix STRING Hayır boş aşağı aktarılır
output_directory STRING Hayır boş aşağı aktarılır

Çıktı: MODEL_INFO. Önkoşul: yerel dosya veya URL. Yaygın hatalar: kaynak eksik/erişilemez, format reddedildi veya import hatası. En küçük bağlantı: yerel dosya veya URL → TripoImportModel → MODEL_INFO.

Boş olmayan model_url, model_file değerinden önceliklidir. İkisi de yoksa düğüm hata verir. Yükleme .glb, .fbx, .obj, .stl, .ply, .3mf ve .gltf kabul eder; backend ayrıca .zip tanır.

Model işleme

TripoTextureModel — Tripo: Texture model

Modele doku uygular.

Girdi Tür Zorunlu Varsayılan Değerler / aralık
model_info MODEL_INFO Evet — üst görev bağlamı
model_version ENUM Hayır v3.0-20250812 v2.5-20250123, v3.0-20250812
texture BOOLEAN Hayır true —
pbr BOOLEAN Hayır true —
texture_seed INT Hayır 42 —
texture_quality ENUM Hayır standard standard, detailed
texture_alignment ENUM Hayır original_image original_image, geometry
text_prompt STRING multiline Hayır boş —
image_prompt IMAGE Hayır — —
style_image IMAGE Hayır — —
part_names STRING multiline Hayır boş satır başına bir ad
compress BOOLEAN Hayır false —
bake BOOLEAN Hayır true —

Çıktı: STRING model_file + MODEL_INFO. Önkoşul: Generate / Import MODEL_INFO. Yaygın hatalar: uyumsuz bağlam, geçersiz görsel veya API hatası. En küçük bağlantı: Generate / Import → TripoTextureModel → Preview 3D.

TripoRefineModel — Tripo: Refine Draft model

Uyumlu taslağı iyileştirir.

Girdi Tür Zorunlu Varsayılan Değerler / aralık
model_info MODEL_INFO Evet — taslak bağlamı

Çıktı: STRING model_file + MODEL_INFO. Önkoşul: işlenebilir taslak MODEL_INFO. Yaygın hatalar: iyileştirilemeyen taslak veya API hatası. En küçük bağlantı: Generate draft → TripoRefineModel → Preview 3D.

TripoMeshSegmentation — Tripo: Segment mesh

Mesh segmentasyonu yapar.

Girdi Tür Zorunlu Varsayılan Değerler / aralık
model_info MODEL_INFO Evet — üst görev bağlamı
model_version ENUM Evet v1.0-20250506 v1.0-20250506, v2.0-20260430
segmentation_granularity ENUM Hayır balanced simple, balanced, detailed; v2 only
ref_image IMAGE Hayır — yalnızca v2
split_by_connectivity BOOLEAN Hayır true yalnızca v2

Çıktı: STRING model_file + MODEL_INFO. Önkoşul: Generate / Import MODEL_INFO. Yaygın hatalar: uyumsuz model/referans veya API hatası. En küçük bağlantı: Generate / Import → TripoMeshSegmentation → Completion / Preview.

segmentation_granularity, ref_image ve split_by_connectivity yalnızca v2.0-20260430 ile gönderilir; v1 bunları yok sayar.

TripoMeshCompletion — Tripo: Complete mesh

Segmentli mesh’i tamamlar.

Girdi Tür Zorunlu Varsayılan Değerler / aralık
model_info MODEL_INFO Evet — segmentli bağlam
model_version ENUM Evet v1.0-20250506 v1.0-20250506
part_names STRING multiline Hayır boş satır başına bir ad

Çıktı: STRING model_file + MODEL_INFO. Önkoşul: segmentli MODEL_INFO. Yaygın hatalar: tamamlamaya uygun olmayan görev veya API hatası. En küçük bağlantı: Segment → TripoMeshCompletion → Preview 3D.

TripoSmartLowPoly — Tripo: Smart low poly

Low-poly model oluşturur.

Girdi Tür Zorunlu Varsayılan Değerler / aralık
model_info MODEL_INFO Evet — üst görev bağlamı
model_version ENUM Evet P-v2.0-20251225 P-v2.0-20251225
quad BOOLEAN Hayır false —
part_names STRING multiline Hayır boş satır başına bir ad
face_limit INT Hayır 10000 -1–20000
bake BOOLEAN Hayır true —

Çıktı: STRING model_file + MODEL_INFO. Önkoşul: Generate / Import MODEL_INFO. Yaygın hatalar: uyumsuz model/parçalar veya API hatası. En küçük bağlantı: Generate / Import → TripoSmartLowPoly → Preview / Convert.

TripoStylizeModel — Tripo: Stylize model

Geometrik stil uygular.

Girdi Tür Zorunlu Varsayılan Değerler / aralık
model_info MODEL_INFO Evet — üst görev bağlamı
style ENUM Evet ilk değer lego, voxel, voronoi, minecraft
block_size INT Evet 80 1–1000

Çıktı: STRING model_file + MODEL_INFO. Önkoşul: Generate / Import MODEL_INFO. Yaygın hatalar: uyumsuz model/stil veya API hatası. En küçük bağlantı: Generate / Import → TripoStylizeModel → Preview 3D.

Rig ve animasyon

TripoAnimateRigNode — Tripo: Rig model

Otomatik rig uygular.

Girdi Tür Zorunlu Varsayılan Değerler / aralık
model_info MODEL_INFO Evet — üst görev bağlamı
model_version ENUM Evet v2.0-20250506 v1.0-20240301, v2.0-20250506
out_format ENUM Evet glb glb, fbx
spec ENUM Evet tripo mixamo, tripo

Çıktı: STRING model_file + MODEL_INFO. Önkoşul: Generate / Import MODEL_INFO. Yaygın hatalar: model rig için uygun değil, rig type yok veya API hatası. En küçük bağlantı: Generate / Import → TripoAnimateRigNode → Retarget / Preview.

Rig işleminden önce düğüm uygunluğu kontrol eder ve bir rig type alır.

TripoAnimateRetargetNode — Tripo: Retarget rigged model

Hazır animasyon uygular.

Girdi Tür Zorunlu Varsayılan Değerler / aralık
model_info MODEL_INFO Evet — rig bağlamı
animation ENUM Evet ilk değer aşağıdaki 16 preset
out_format ENUM Evet glb glb, fbx
bake_animation BOOLEAN Hayır true —
export_with_geometry BOOLEAN Hayır false —

Çıktı: STRING model_file + MODEL_INFO. Önkoşul: rig uygulanmış MODEL_INFO. Yaygın hatalar: rig uygulanmamış bağlam veya API hatası. En küçük bağlantı: Rig → TripoAnimateRetargetNode → Preview / Convert.

16 animasyon değeri: preset:idle, preset:walk, preset:run, preset:dive, preset:climb, preset:jump, preset:slash, preset:shoot, preset:hurt, preset:fall, preset:turn, preset:quadruped:walk, preset:hexapod:walk, preset:octopod:walk, preset:serpentine:march, preset:aquatic:march.

Format çıktısı

TripoConvertNode — Tripo: Convert model

Modeli dönüştürür ve dışa aktarır.

Girdi Tür Zorunlu Varsayılan Değerler / aralık
model_info MODEL_INFO Evet — üst görev bağlamı
format ENUM Evet ilk değer GLTF, USDZ, FBX, OBJ, STL, 3MF
quad BOOLEAN Hayır false —
force_symmetry BOOLEAN Hayır false —
face_limit INT Hayır -1 -1–500000
flatten_bottom BOOLEAN Hayır false —
flatten_bottom_threshold FLOAT Hayır 0.01 0.0–1.0
texture_size INT Hayır 4096 128–4096
texture_format ENUM Hayır JPEG BMP, DPX, HDR, JPEG, OPEN_EXR, PNG, TARGA, TIFF, WEBP
pivot_to_center_bottom BOOLEAN Hayır false —
scale_factor FLOAT Hayır 1.0 en az 0
with_animation BOOLEAN Hayır true —
pack_uv BOOLEAN Hayır false —
bake BOOLEAN Hayır true —
part_names STRING multiline Hayır boş satır başına bir ad
fbx_preset ENUM Hayır blender blender, mixamo, 3dsmax
export_vertex_colors BOOLEAN Hayır false —
export_orientation ENUM Hayır +x +x, +y, -x, -y
animate_in_place BOOLEAN Hayır false —

Çıktı: STRING model_file. Önkoşul: uyumlu MODEL_INFO. Yaygın hatalar: desteklenmeyen dönüşüm, geçersiz ayar veya çıktı hatası. En küçük bağlantı: MODEL_INFO → TripoConvertNode.

Convert bir çıktı düğümüdür ve MODEL_INFO döndürmez.

Workflow örnekleri

Preview 3D yalnızca isteğe bağlı ComfyUI görüntüleyicisidir.

flowchart LR
    T["Metin"] --> GT["Generate model<br/>mode: text_to_model"]
    IM["Görsel"] --> GI["Generate model<br/>mode: image_to_model"]
    MV["Ön + isteğe bağlı görünümler"] --> GM["Generate model<br/>mode: multiview_to_model"]
    GT --> V["Preview 3D"]
    GI --> V
    GM --> V
  1. Text to Model: prompt → text_to_model ile Generate → Preview 3D.
  2. Image to Model: IMAGE → image, image_to_model modu → Preview 3D.
  3. Multiview to Model: ön görünüm image; diğerleri image_left, image_back, image_right.
  4. Texture Model: Generate/Import → MODEL_INFO → Texture → Preview.
  5. Refine Model: uyumlu taslak → MODEL_INFO → Refine → Preview.
  6. Rig and Retarget: Generate/Import → Rig → Retarget; MODEL_INFO bağlayın.
  7. Import and Process: dosya/URL → Import → Segment/Smart low poly/Stylize/Texture.
  8. Convert and Export: son MODEL_INFO → Convert → format.

Resmî workflow PNG dosyaları

Aşağıdaki altı PNG gömülü ComfyUI workflow verisi içerir. İndirme bağlantısıyla orijinali kaydedip ComfyUI’ye sürükleyin veya elle yükleyin. Görsellerdeki parametre değerleri yalnızca örnektir; güncel varsayılanlar için parametre tablolarını kullanın.

Text to Mesh

Tripo Generate model ve Preview 3D içeren metinden mesh workflow

Metinden model oluşturur ve model_file değerini Preview 3D’ye gönderir.

Orijinal workflow PNG dosyasını indir

Image to Mesh

Load Image, Tripo Generate model ve Preview 3D içeren görüntüden mesh workflow

Görüntüyü yükler, image_to_model modundaki Generate model düğümüne bağlar ve sonucu gösterir.

Orijinal workflow PNG dosyasını indir

Multiview Images to Mesh

Üç Load Image, Tripo Generate model ve Preview 3D içeren çoklu görünüm workflow

Ön ve isteğe bağlı yan görünümleri multiview_to_model modundaki Generate model düğümüne bağlar.

Orijinal workflow PNG dosyasını indir

Texture a generated model

Generate model, Texture model ve Preview 3D içeren doku workflow

Generate model çıktısındaki MODEL_INFO değerini Texture model düğümüne verir ve iki çıktıyı gösterir.

Orijinal workflow PNG dosyasını indir

Refine a draft Mesh

Generate model, Refine Draft model ve Preview 3D içeren iyileştirme workflow

Uyumlu taslak oluşturur, MODEL_INFO değerini Refine Draft model düğümüne verir ve sonucu gösterir.

Orijinal workflow PNG dosyasını indir

Animation / Rig and export

Generate model, Rig model, Preview 3D ve Convert model içeren rig ve dışa aktarma workflow

Orijinal workflow PNG dosyasını indir

Çıktı ve sorun giderme

İndirmeler varsayılan olarak ComfyUI/output içine yazılır. file_prefix dosyayı adlandırır, output_directory taşır; ikisi de MODEL_INFO ile aktarılır.

Belirti Kontrol
API Key eksik Düğüm anahtarı, TRIPO_API_KEY veya config.json ayarlayın.
Prompt/ön görünüm eksik Modu ve koşullu girdiyi kontrol edin.
Import başlamıyor Erişilebilir URL veya mevcut dosya verin; URL önceliklidir.
Model rig için uygun değil Uygun karakter modeli kullanın.
API görevi başarısız error_code, error_msg, erişim ve bakiyeyi kontrol edin.
Çıktı taşınamıyor Hedef yolu ve yazma iznini kontrol edin.
Düğümler görünmüyor ComfyUI’yi yeniden başlatın; dizin ve requirements.txt kontrol edin.
Yükleme başarısız Uzantıyı ve ComfyUI yükleme yanıtını kontrol edin.