> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# TripoP1TextToModelNode - ComfyUI Built-in Node Documentation

> Tripo P1 文本转 3D。

Tripo P1 文本转 3D。此节点使用 Tripo P1 API 根据文本描述生成 3D 模型。它针对创建具有稳定拓扑的低多边形、游戏就绪网格进行了优化，适合实时应用。

## 输入

### 通用输入

| 参数      | 描述                                                                                        | 数据类型           | 必需 | 范围                                  |
| ------- | ----------------------------------------------------------------------------------------- | -------------- | -- | ----------------------------------- |
| `输出模式`  | 控制生成的模型仅包含几何体还是还包含颜色/PBR 纹理。"Geometry only" 返回无纹理网格。"Textured" 添加颜色/PBR 贴图并显示下方的纹理选项。     | DYNAMIC\_COMBO | 是  | `"Geometry only"`<br />`"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"`<br />`"detailed"`<br />`"extreme"` |
| `texture_seed`    | 用于纹理生成的种子值，用于控制随机性。默认：42。                                 | INT     | 是  | 0 到 2147483647                                  |

## 输出

| 输出名称            | 描述                 | 数据类型            |
| --------------- | ------------------ | --------------- |
| `model_file`    | 生成的模型文件名，仅为向后兼容保留。 | STRING          |
| `model task_id` | 模型生成请求的唯一任务 ID。    | MODEL\_TASK\_ID |
| `GLB`           | 生成的 GLB 格式 3D 模型。  | FILE3DGLB       |

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

***

**Source fingerprint (SHA-256):** `53a5573384294612b912558436e82f3481717d2ba3d50b73f1e40c3065aff2a0`