> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-nav-cta-ab-test-try-cloud-free.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

#  Tripo 合作伙伴节点模型生成 ComfyUI 官方示例

> 本文将介绍如何在 ComfyUI 中使用 Tripo 节点的 API 来进行模型生成

Tripo AI 是一家专注于生成式 AI 3D 建模的公司，它提供用户友好的平台和 API 服务，能够快速地将文本提示或2D图像（单张或多张）转换成高质量的3D模型。
目前 ComfyUI 已原生集成了对应 Tripo API ,现在你可以在 ComfyUI 中便捷地使用相关节点来进行模型生成

目前 ComfyUI 的 合作伙伴节点中已经支持 Tripo 以下模型生成能力：

* 文生模型
* 图生模型
* 多视图模型生成
* 骨骼绑定
* 重定向骨骼模型

<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)

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

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

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

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

      所以，如果你发现本文档中有任何核心节点缺失，可能是因为新核心节点尚未在最新稳定版中发布。请等待下一个稳定版发布。
    </Tab>
  </Tabs>
</Tip>

## 文生模型工作流

使用 Tripo 的文生模型功能，通过文本提示词生成3D模型。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_tripo_text_to_model-1.webp" alt="Tripo 文生模型工作流预览" />

<CardGroup cols={2}>
  <Card title="在云端运行文生模型" icon="cloud" href="https://cloud.comfy.org/?template=api_tripo_text_to_model&utm_source=docs&utm_medium=referral&utm_campaign=model-generation">
    立即在 Comfy Cloud 上体验文生模型工作流。
  </Card>

  <Card title="下载文生模型工作流" icon="download" href="https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/api_nodes/tripo/api_tripo_text_to_model.json">
    下载 JSON 文件，在 ComfyUI 中本地运行。
  </Card>
</CardGroup>

### 2. 按步骤完成工作流的执行

<img src="https://mintcdn.com/dripart-docs-nav-cta-ab-test-try-cloud-free/uZUIdcSBLoopnfbh/images/tutorial/api_nodes/tripo/tripo_text_to_model_step_guide.jpg?fit=max&auto=format&n=uZUIdcSBLoopnfbh&q=85&s=d12278ce44f1c69bdc3445a2fdd4ff66" alt="ComfyUI Tripo 文生模型步骤指南" width="2318" height="1564" data-path="images/tutorial/api_nodes/tripo/tripo_text_to_model_step_guide.jpg" />

你可参考图片中的序号来完成最基础的文生模型工作流执行：

1. 在 `Tripo: Text to Model` 节点的 `prompt` 字段中输入提示词
   * model：可以选择不同的模型，目前仅 v1.4 模型支持使用 `Tripo: Refine Draft model` 进行后续优化
   * style：可以设置不同的风格
   * texture\_quality：可以设置不同的纹理质量
2. 点击 `Run` 按钮，或使用快捷键 `Ctrl(cmd) + Enter` 来执行模型生成。工作流完成后，对应的模型将自动保存到 `ComfyUI/output/` 目录中
3. 在 `Preview 3D` 节点中，点击展开菜单
4. 选择 `Export` 即可直接导出对应模型

## 图生模型工作流

从单张图像输入生成 3D模型。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_tripo_image_to_model-1.webp" alt="Tripo 图生模型工作流预览" />

<CardGroup cols={2}>
  <Card title="在云端运行图生模型" icon="cloud" href="https://cloud.comfy.org/?template=api_tripo_image_to_model&utm_source=docs&utm_medium=referral&utm_campaign=model-generation">
    立即在 Comfy Cloud 上尝试图生模型工作流。
  </Card>

  <Card title="下载图生模型工作流" icon="download" href="https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/api_nodes/tripo/image_to_model/api_tripo_image_to_model.json">
    下载 JSON 以在 ComfyUI 中本地运行。
  </Card>
</CardGroup>

<details className="prose" style={{marginBottom:"1rem"}}>
  <summary>输入材料</summary>

  下载此示例输入图像以尝试该工作流：

  <CardGroup cols={1}>
    <Card title="输入图像" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/api_tripo_image_to_model_input_image.jpg">
      下载示例输入图像
    </Card>
  </CardGroup>
</details>

![输入图像](https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/api_nodes/tripo/image_to_model/panda.jpg)

### 2. 按步骤完成工作流的执行

<img src="https://mintcdn.com/dripart-docs-nav-cta-ab-test-try-cloud-free/uZUIdcSBLoopnfbh/images/tutorial/api_nodes/tripo/tripo_image_to_model_step_guide.jpg?fit=max&auto=format&n=uZUIdcSBLoopnfbh&q=85&s=95fbc3ebb3ebe1ddc1c7f59f7a44999a" alt="ComfyUI Tripo 文生模型分步指南" width="2242" height="2610" data-path="images/tutorial/api_nodes/tripo/tripo_image_to_model_step_guide.jpg" />

你可参考图片中的序号来完成最基础的图生模型工作流执行：

1. 在 `Load Image` 节点中加载提供的输入图像
2. 在 `Tripo: Image to Model` 节点中修改对应的参数设置
   * model：可以选择不同的模型，目前仅 v1.4 模型支持使用 `Tripo: Refine Draft model` 进行后续优化
   * style：可以设置不同的风格
   * texture\_quality：可以设置不同的纹理质量
3. 点击 `Run` 按钮，或者使用快捷键 `Ctrl(cmd) + Enter` 来执行模型的生成。工作流完成后，对应的模型会自动保存至 `ComfyUI/output/` 目录下
4. 模型下载请参考文生模型部分的说明

## 多视图模型生成工作流

通过多视图图像生成 3D 模型，以获得更高的精度。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_tripo_multiview_to_model-1.webp" alt="Tripo 多视图模型生成工作流预览" />

<CardGroup cols={2}>
  <Card title="在云端运行多视图模型生成" icon="cloud" href="https://cloud.comfy.org/?template=api_tripo_multiview_to_model&utm_source=docs&utm_medium=referral&utm_campaign=model-generation">
    立即在 Comfy Cloud 上体验多视图模型生成工作流。
  </Card>

  <Card title="下载多视图模型生成工作流" icon="download" href="https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/api_nodes/tripo/multiview_to_image/api_tripo_multiview_to_model.json">
    下载 JSON 以在 ComfyUI 中本地运行。
  </Card>
</CardGroup>

<details className="prose" style={{marginBottom:"1rem"}}>
  <summary>输入材料</summary>

  下载这些示例输入图像以尝试该工作流：

  <CardGroup cols={2}>
    <Card title="前视图" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/api_tripo_multiview_to_model_front_image.jpg">
      下载前视图输入
    </Card>

    <Card title="后视图" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/api_tripo_multiview_to_model_back_image.jpg">
      下载后视图输入
    </Card>
  </CardGroup>
</details>

![前视图](https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/api_nodes/tripo/multiview_to_image/front.jpg)
![后视图](https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/api_nodes/tripo/multiview_to_image/back.jpg)

### 2. 按步骤完成工作流的执行

<img src="https://mintcdn.com/dripart-docs-nav-cta-ab-test-try-cloud-free/uZUIdcSBLoopnfbh/images/tutorial/api_nodes/tripo/tripo_multiview_to_model_step_guide.jpg?fit=max&auto=format&n=uZUIdcSBLoopnfbh&q=85&s=64b65cda5aa00f027b97b958f170c273" alt="ComfyUI Tripo Text to Model Step Guide" width="4474" height="2210" data-path="images/tutorial/api_nodes/tripo/tripo_multiview_to_model_step_guide.jpg" />

你可参考图片中的序号来完成最基础的多视图模型生成工作流执行：

1. 在 `Load Image` 节点中分别加载提供的输入图像
2. 在 `Tripo: Image to Model` 节点中修改对应的参数设置
   * model：可以选择不同的模型，目前仅 v1.4 模型支持 `Tripo: Refine Draft model` 的后续优化
   * style：可以设置不同的风格
   * texture\_quality：可以设置不同的纹理质量
3. 点击 `Run` 按钮，或者使用快捷键 `Ctrl(cmd) + Enter` 来执行模型生成。工作流完成后，对应的模型会自动保存至 `ComfyUI/output/` 目录下
4. 对于其他视图输入，可以参考步骤图中的示意，将对应节点的模式设置为 `Always` 来启用
5. 模型下载请参考文生模型部分的说明

## 对应任务的后续任务处理

Tripo 的对应节点提供了对于同一任务的后续处理，只需要在相关节点中输入对应的`model_task_id` 即可,我们在相关模板中也已提供了对应的节点，你也可以按需通过修改对应节点模式来启用

<img src="https://mintcdn.com/dripart-docs-nav-cta-ab-test-try-cloud-free/uZUIdcSBLoopnfbh/images/tutorial/api_nodes/tripo/other_nodes.jpg?fit=max&auto=format&n=uZUIdcSBLoopnfbh&q=85&s=f782e883485684e7bee5e64c491a246e" alt="Tripo 任务处理" width="904" height="696" data-path="images/tutorial/api_nodes/tripo/other_nodes.jpg" />

<Error>
  其中 `Tripo: Refine Draft model` 节点只对 V1.4 模型支持，其它模型不支持
</Error>