> ## 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.

# Tripo P1 3D 模型生成 ComfyUI 官方示例

> 本指南介绍如何在 ComfyUI 中使用 Tripo P1 Partner Nodes，从文本、图片或多视图参考生成可直接用于游戏的 3D 模型

[Tripo P1](/zh/built-in-nodes/TripoP1ImageToModelNode) Partner Nodes 可从文本提示、单张图片或多视图参考快速生成高质量的 3D 模型。生成的模型具有干净的拓扑结构、优化的多边形预算，并支持贴图、骨骼绑定和重定向，可直接用于游戏引擎和 3D 应用。

在本指南中，我们将介绍三种 Tripo P1 工作流：文本转模型、图片转模型和多视图转模型。

<Tip>
  使用 API 节点需要保证你已经正常登录，并在受许可的网络环境下使用，请参考[API 节点总览](/zh/tutorials/partner-nodes/overview)部分文档来了解使用 API 节点的具体使用要求。
</Tip>

<Tip>
  <Tabs>
    <Tab title="本地用户">
      请确保你的 ComfyUI 已经更新。

      * [ComfyUI 下载](https://www.comfy.org/download)
      * [ComfyUI 更新教程](/zh/installation/update_comfyui)

      本指南里的工作流可以在 ComfyUI 的[工作流模板](/zh/interface/features/template)中找到。如果找不到，可能是 ComfyUI 没有更新。

      如果加载工作流时有节点缺失，可能原因有：

      1. 你用的不是最新开发版（nightly）。
      2. 启动时有些节点导入失败。
    </Tab>

    <Tab title="云端用户">
      * [Cloud](https://cloud.comfy.org) 会在 ComfyUI 稳定版本发布后更新，我们会同步更新 Cloud。

      所以，如果你发现本教程中有任何核心节点缺失，那是因为对应的节点支持还在开发中没有发布正式的稳定版，请等待下一个稳定版本发布。
    </Tab>
  </Tabs>
</Tip>

## Tripo P1: 文本转模型

从文本描述生成 3D 模型。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_tripo_p1_text_to_model-1.webp" alt="Tripo P1 文本转模型工作流" />

<CardGroup cols={2}>
  <Card title="在 Comfy Cloud 中运行" icon="cloud" href="https://cloud.comfy.org/?template=api_tripo_p1_text_to_model&utm_source=docs&utm_medium=referral&utm_campaign=tripo_p1_t2m">
    打开 Comfy Cloud
  </Card>

  <Card title="下载工作流" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_tripo_p1_text_to_model.json">
    下载 JSON 或在模板库中搜索 "Tripo P1: Text to Model"
  </Card>
</CardGroup>

### 运行步骤

1. **输入提示词** — 在 **TripoP1TextToModelNode** 中描述 3D 模型
2. **选择贴图模式** — 可选 Textured、None 或 PBR
3. **启用细化** — 开启四边形重构以获得更干净的拓扑
4. **设置种子** — 控制生成结果的可复现性
5. **点击执行** — 按 `Ctrl+Enter` 生成
6. **预览和导出** — 使用 **Preview3D** 预览，**SaveGLB** 导出

### 关键处理节点

初始生成后，工作流自动依次处理：

* **TripoTextureNode** — 应用材质和贴图
* **TripoConversionNode** — 转换为 GLTF 格式（或其他导出格式）
* **TripoRefineNode** — 优化拓扑和几何结构
* **TripoRigNode** — 添加骨骼用于动画
* **TripoRetargetNode** — 应用预设动画（默认空闲动画）

## Tripo P1: 图片转模型

从单张参考图片生成 3D 模型。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_tripo_p1_image_to_model-1.webp" alt="Tripo P1 图片转模型工作流" />

<CardGroup cols={2}>
  <Card title="在 Comfy Cloud 中运行" icon="cloud" href="https://cloud.comfy.org/?template=api_tripo_p1_image_to_model&utm_source=docs&utm_medium=referral&utm_campaign=tripo_p1_i2m">
    打开 Comfy Cloud
  </Card>

  <Card title="下载工作流" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_tripo_p1_image_to_model.json">
    下载 JSON 或在模板库中搜索 "Tripo P1: Image to Model"
  </Card>
</CardGroup>

### 运行步骤

1. **上传参考图片** — 使用 **LoadImage** 节点加载主体的正面图像
2. **选择贴图模式** — 可选 Textured、None 或 PBR
3. **启用细化** — 开启四边形重构
4. **选择贴图类型** — 可选 `original_image` 或 `standard`
5. **点击执行** — 按 `Ctrl+Enter` 生成

## Tripo P1: 多视图转模型

从多个视角的图片生成更精准的 3D 模型。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_tripo_p1_mv_to_model-1.webp" alt="Tripo P1 多视图转模型工作流" />

<CardGroup cols={2}>
  <Card title="在 Comfy Cloud 中运行" icon="cloud" href="https://cloud.comfy.org/?template=api_tripo_p1_mv_to_model&utm_source=docs&utm_medium=referral&utm_campaign=tripo_p1_mv">
    打开 Comfy Cloud
  </Card>

  <Card title="下载工作流" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_tripo_p1_mv_to_model.json">
    下载 JSON 或在模板库中搜索 "Tripo P1: Multiview to Model"
  </Card>
</CardGroup>

### 运行步骤

1. **上传多视图图片** — 使用多个 **LoadImage** 节点加载正面、左侧、背面等角度的图像
2. **选择贴图模式** — 可选 Textured、None 或 PBR
3. **选择细节级别** — 可选 `standard` 或 `detailed`
4. **设置贴图参考** — 选择哪个图像驱动贴图
5. **点击执行** — 按 `Ctrl+Enter` 生成

### 输入建议

* 至少提供**正面和侧面视图**可获得最佳效果
* 确保所有参考图像的光照和姿态一致
* 更高质量的输入图片可生成更好的贴图效果
