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.
本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! 在 GitHub 上编辑
## 概述
此节点根据物体或角色的 2 到 4 张参考图像生成 3D 模型。您提供不同角度(正面、左侧、背面、右侧)的图像,节点将创建 GLB 格式的 3D 网格。正面视图为必填项,您可以选择添加其他三个视图的任意组合以获得更好的效果。## 输入
| 参数 | 数据类型 | 是否必填 | 范围 | 描述 |
|---|---|---|---|---|
image | IMAGE | 是 | - | 正面视图(0°)。必填。 |
image_left | IMAGE | 否 | - | 左侧视图(90°),即物体的左侧。 |
image_back | IMAGE | 否 | - | 背面视图(180°)。 |
image_right | IMAGE | 否 | - | 右侧视图(270°),即物体的右侧。 |
output_mode | COMBO | 是 | "geometry""textured""detailed" | 生成模型的输出模式。"geometry" 生成原始网格,"textured" 添加标准纹理,"detailed" 创建高细节纹理模型(默认值:"textured")。 |
face_limit | INT | 否 | -1 到 100000 | 输出网格的最大面数。设置为 -1 表示无限制(默认值:-1)。 |
model_seed | INT | 否 | 0 到 2147483647 | 用于可重复模型生成的种子。设置为 0 表示随机(默认值:0)。 |
auto_size | BOOLEAN | 否 | True / False | 自动调整模型大小以适配标准边界框(默认值:False)。 |
export_uv | BOOLEAN | 否 | True / False | 随模型导出 UV 坐标(默认值:True)。 |
compress_geometry | BOOLEAN | 否 | True / False | 压缩几何数据以减小文件大小(默认值:False)。 |
image)加上至少一个其他视图(image_left、image_back 或 image_right)。如果提供的图像少于 2 张,节点将报错。
## 输出
| 输出名称 | 数据类型 | 描述 |
|---|---|---|
model_file | STRING | 生成的 GLB 模型文件名(仅用于向后兼容)。 |
model_task_id | MODEL_TASK_ID | 此模型生成请求的唯一任务 ID。 |
GLB | FILE3DGLB | 生成的 GLB 格式 3D 模型。 |
Source fingerprint (SHA-256):
29bb87cdc5d3eef891a653c622e8876a37d6e6dc1a43e5c248b184060ead9029