ComfyUI 集成——Tripo API 在节点工作流中的使用

ComfyUI 是什么

ComfyUI 是基于节点式的 Stable Diffusion / Flux 工作流界面。你用连线的方式把不同节点串起来——输入节点 → 模型节点 → 处理节点 → 输出节点——形成一个自动化的图像生成管线。

为什么要集成 Tripo

ComfyUI 擅长 2D 图像生成（SDXL、Flux 等），但不能生成 3D。集成 Tripo API 后，你的管线可以变成：

文本提示词 → Flux 生成参考图 → Tripo API → 3D 模型 → 自动保存

或：

单张产品照片 → Tripo API → 3D 模型 → 自动保存到输出目录

Tripo 在 ComfyUI 里的节点

Tripo 提供的 ComfyUI 节点（或社区维护的节点）通常包含：

• 文本 → 3D 模型节点
• 图片 → 3D 模型节点
• 多视图 → 3D 模型节点
• 结果预览节点（在 ComfyUI 里直接看到生成的 3D 模型）
• 导出节点（自动保存 GLB / FBX）

环境准备

1. 安装 Tripo ComfyUI 节点：从官方仓库或社区获取节点代码，放入 ComfyUI 的 custom_nodes 目录
2. 配置 API Key：在 Tripo 开发者平台（developers.tripo3d.com）申请 API Key，配置到节点里
3. 网络通畅：Tripo API 服务端在海外，可能需要稳定的海外网络环境

典型工作流

文本 → 3D

1. Load Checkpoint + CLIP Text Encode（和普通 SD 工作流一样）
2. Tripo Text to 3D 节点：把文本编码结果喂进去
3. 节点异步调用 Tripo API，生成 3D 模型
4. Preview 3D 节点：在 ComfyUI 里预览模型
5. Save GLB 节点：自动保存到 ComfyUI/output/ 目录

图片 → 3D

1. Load Image（加载一张照片或 Flux 生成的参考图）
2. Tripo Image to 3D 节点：把图片喂进去
3. 异步生成 → 预览 → 保存

关键区别：Studio vs API

API 积分

再次强调：API 积分 ≠ Studio 积分。它们是两套独立的计费体系，不能互用。ComfyUI 集成消耗的是 API 积分，不是你在 Studio 里充的积分。

输出位置

ComfyUI 运行完成后，生成的模型会自动保存到 ComfyUI 的 output/ 目录。Studio 节点的预览功能会在 ComfyUI 界面里渲染一个简单的 3D 预览。

故障排查