文档 /
节点说明 /
Tripo P1:文本转模型
Tripo P1:文本转模型
Tripo P1 文本转 3D。此节点使用 Tripo P1 API 根据文本描述生成 3D 模型。
节点说明
TripoP1TextToModelNode 更新于 2026-11-12
Tripo P1:文本转模型 - ComfyUI Built-in Node Documentation
Tripo P1 文本转 3D。此节点使用 Tripo P1 API 根据文本描述生成 3D 模型。
Tripo P1 文本转 3D。此节点使用 Tripo P1 API 根据文本描述生成 3D 模型。它针对创建具有稳定拓扑的低多边形、游戏就绪网格进行了优化,适合实时应用。
输入
通用输入
| 参数 | 描述 | 数据类型 | 必需 | 范围 |
|---|---|---|---|---|
输出模式 | 控制生成的模型仅包含几何体还是还包含颜色/PBR 纹理。"Geometry only" 返回无纹理网格。"Textured" 添加颜色/PBR 贴图并显示下方的纹理选项。 | DYNAMIC\_COMBO | 是 | "Geometry only" "Textured" |
提示词 | 要生成的 3D 模型的文本描述。最多 1024 个字符。必需,不能为空。 | STRING | 是 | 最多 1024 个字符 |
反向提示词 | 不希望生成的模型中出现的文本描述。最多 255 个字符。默认:未设置。 | STRING | 否 | 最多 255 个字符 |
图像种子 | 用于控制随机性的种子值。默认:42。 | INT | 否 | 0 到 2147483647 |
面数限制 | 目标面数,48-20000。-1 让 Tripo 自适应选择。默认:-1。 | INT | 否 | -1 到 20000 |
模型种子 | 用于控制随机性的种子值。默认:42。 | INT | 否 | 0 到 2147483647 |
自动缩放 | 将输出缩放至接近真实世界米数。默认:False。 | BOOLEAN | 否 | True / False |
导出 UV | 生成过程中进行 UV 展开。关闭可加快仅几何运行速度。默认:True。 | BOOLEAN | 否 | True / False |
压缩几何体 | 应用 meshopt 几何压缩(EXT\_meshopt\_compression)。文件更小,但 ComfyUI 的 3D 预览无法显示它们;编辑前请先解压。默认:False。 | BOOLEAN | 否 | True / False |
Geometry only 输入
当 output_mode 设置为 "Geometry only" 时,没有额外输入可用。在此模式下,纹理相关参数不会发送到 Tripo。
Textured 输入
这些输入仅在 output_mode 设置为 "Textured" 时出现。
| 参数 | 描述 | 数据类型 | 必需 | 范围 |
|---|---|---|---|---|
pbr | 包含 PBR 贴图。开启时,基础纹理也会强制开启。默认:True。 | BOOLEAN | 是 | True / False |
texture_quality | 纹理质量预设。detailed = HD 纹理,extreme = 8K 超高清纹理。默认:"standard"。 | COMBO | 是 | "standard" "detailed" "extreme" |
texture_seed | 用于纹理生成的种子值,用于控制随机性。默认:42。 | INT | 是 | 0 到 2147483647 |
输出
| 输出名称 | 描述 | 数据类型 |
|---|---|---|
model_file | 生成的模型文件名,仅为向后兼容保留。 | STRING |
model task_id | 模型生成请求的唯一任务 ID。 | MODEL\_TASK\_ID |
GLB | 生成的 GLB 格式 3D 模型。 | FILE3DGLB |
本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! 在 GitHub 上编辑
Source fingerprint (SHA-256): 53a5573384294612b912558436e82f3481717d2ba3d50b73f1e40c3065aff2a0