> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# TripoTextToModelNode - ComfyUI Built-in Node Documentation

> 此旧版节点使用 Tripo 的 API 根据文本描述生成成品 3D 模型。

此旧版节点使用 Tripo 的 API 根据文本描述生成成品 3D 模型。它会等待生成完成，然后返回模型文件，并可选包含纹理和 PBR 材质。它已被标记为弃用，仅为兼容旧工作流而保留。

## 输入

| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| - | - | - | - | - |
| `提示词` | 要生成的 3D 模型的文本描述（多行）。此参数为必填项，不能为空。 | STRING | 是 | - |
| `负面提示词` | 要避免在生成模型中出现的文本描述（多行）。最多 255 个字符。仅在非空时发送到 API。 | STRING | 否 | 最多 255 个字符 |
| `模型版本` | 用于生成的 Tripo 模型版本（默认：v3\_1\_20260211）。 | COMBO | 否 | 多个可用选项 |
| `风格` | Tripo 已不再支持并被忽略。为兼容旧工作流而保留（默认："None"）。 | COMBO | 否 | 多个可用选项 |
| `纹理` | 生成纹理贴图。关闭时返回裸几何体并忽略 `pbr`（默认：True）。 | BOOLEAN | 否 | true / false |
| `PBR` | PBR 材质贴图（基础色、金属度、粗糙度、法线）。需要 `texture`；当 `texture` 关闭时会强制关闭（默认：True）。 | BOOLEAN | 否 | true / false |
| `图像种子` | 用于图像生成阶段的种子（默认：42）。 | INT | 否 | 0 到 2147483647 |
| `模型种子` | 用于模型生成阶段的种子（默认：42）。 | INT | 否 | 0 到 2147483647 |
| `纹理种子` | 用于纹理生成阶段的种子（默认：42）。 | INT | 否 | 0 到 2147483647 |
| `纹理质量` | 生成纹理的质量。detailed = HD 纹理，extreme = 8K Ultra 纹理（默认：standard）。 | COMBO | 否 | "standard"<br />"detailed"<br />"extreme" |
| `面数限制` | 最大面数。-1 让 Tripo 自适应选择（在 v3.x standard 下约 140 万面，在 detailed 下约 200 万面）。Tripo 会静默限制：v2.5 为 500,000，四边形网格为 150,000。（默认：-1） | INT | 否 | -1 到 2000000 |
| `四边形` | 四边形网格输出。Tripo 以 FBX 格式交付四边形网格，因此结果会出现在 FBX 输出上，而 GLB 输出保持为空。（默认：False） | BOOLEAN | 否 | true / false |
| `几何质量` | 生成几何体的质量（默认：standard）。 | COMBO | 否 | "standard"<br />"detailed" |
| `smart_low_poly` | 具有干净、手工风格拓扑的低多边形网格（500-20,000 个面，quad 为 500-10,000）。最适合简单主体；复杂主体可能会失败。（默认：False） | BOOLEAN | 否 | true / false |
| `auto_size` | 将带纹理模型缩放到其以米为单位的真实世界尺寸。Tripo 会将尺寸存储为模型的场景变换，并在模型被转换、绑定或重定向时将其烘焙进去；没有纹理时会被忽略。（默认：True） | BOOLEAN | 否 | true / false |

**注意：**

* 此节点已弃用，并标记为旧版节点。保留它是为了向后兼容旧工作流。
* `prompt` 参数为必填项：空提示会导致节点抛出错误。
* `pbr` 需要 `texture`。当 `texture` 关闭时，节点会强制关闭 `pbr` 并忽略其值。没有 `texture` 时，`auto_size` 也不起作用。
* 当启用 `smart_low_poly` 且 `face_limit` 设置为 -1 以外的值时，对于三角形输出，面数限制必须介于 500 和 20,000 之间；当启用 `quad` 时，必须介于 500 和 10,000 之间；否则节点会抛出错误。
* 当启用 `quad` 时，生成的四边形网格以 FBX 格式交付，因此 FBX 输出会被填充，而 GLB 输出保持为空。
* `style` 参数会被接受但会被忽略。

## 输出

| 输出名称 | 描述 | 数据类型 |
| - | - | - |
| `模型文件` | 生成的 3D 模型文件名，格式为 `<task_id>.<format>`，仅为向后兼容而保留。 | STRING |
| `模型任务ID` | 模型生成过程的唯一任务标识符。 | MODEL\_TASK\_ID |
| `GLB` | 生成的 GLB 格式 3D 模型。启用 `quad` 时为空。 | FILE3DGLB |
| `FBX` | 生成的 FBX 格式 3D 模型。仅在启用 `quad` 时填充。 | FILE3DFBX |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TripoTextToModelNode/zh.md)

***

**Source fingerprint (SHA-256):** `c26c8437ea66d08f7f39865fedeaaf4cf8583ca64b368f3b767ea18918dd6c08`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.