跳转到主要内容

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 网格。正面视图为必填项,您可以选择添加其他三个视图的任意组合以获得更好的效果。

## 输入

参数数据类型是否必填范围描述
imageIMAGE-正面视图(0°)。必填。
image_leftIMAGE-左侧视图(90°),即物体的左侧。
image_backIMAGE-背面视图(180°)。
image_rightIMAGE-右侧视图(270°),即物体的右侧。
output_modeCOMBO"geometry"
"textured"
"detailed"
生成模型的输出模式。"geometry" 生成原始网格,"textured" 添加标准纹理,"detailed" 创建高细节纹理模型(默认值:"textured")。
face_limitINT-1 到 100000输出网格的最大面数。设置为 -1 表示无限制(默认值:-1)。
model_seedINT0 到 2147483647用于可重复模型生成的种子。设置为 0 表示随机(默认值:0)。
auto_sizeBOOLEANTrue / False自动调整模型大小以适配标准边界框(默认值:False)。
export_uvBOOLEANTrue / False随模型导出 UV 坐标(默认值:True)。
compress_geometryBOOLEANTrue / False压缩几何数据以减小文件大小(默认值:False)。
注意: 您必须至少提供 2 张图像:正面视图(image)加上至少一个其他视图(image_leftimage_backimage_right)。如果提供的图像少于 2 张,节点将报错。

## 输出

输出名称数据类型描述
model_fileSTRING生成的 GLB 模型文件名(仅用于向后兼容)。
model_task_idMODEL_TASK_ID此模型生成请求的唯一任务 ID。
GLBFILE3DGLB生成的 GLB 格式 3D 模型。

Source fingerprint (SHA-256): 29bb87cdc5d3eef891a653c622e8876a37d6e6dc1a43e5c248b184060ead9029