# Узлы ComfyUI

ComfyUI-Tripo — официальное расширение Tripo с пользовательскими узлами для ComfyUI. Оно добавляет в рабочие процессы ComfyUI генерацию 3D-моделей по тексту, изображениям или нескольким ракурсам, а также импорт моделей, текстурирование, уточнение, обработку сетки, low-poly-оптимизацию, стилизацию, риггинг, перенос анимации, преобразование форматов и ретопологию.

| Параметр | Значение |
| --- | --- |
| Версия проекта Node | <code>1.3.0</code> |
| Тег исходников | <code>v1.3.1.1</code> |
| Репозиторий | [VAST-AI-Research/ComfyUI-Tripo](https://github.com/VAST-AI-Research/ComfyUI-Tripo) |

## Возможности и журнал изменений

### Возможности

- Генерация 3D-моделей по тексту.
- Генерация 3D-моделей по изображениям.
- Импорт моделей по URL через <code>model_url</code>.
- Поддерживает разделение модели на части.
- Риггинг и анимация 3D-моделей.
- Конвертация форматов и ретопология.

### Журнал изменений

- 2026-06-30: добавлены Mesh Segmentation v2.0 для разделения моделей на части и прямой импорт по URL через <code>model_url</code>.
- 2026-05-28: добавлен импорт моделей.
- 2025-06-19: выполнен переход на новейший API и добавлены узлы.
- 2025-03-31: выполнен переход на пакет <code>tripo3d</code>.
- 2025-02-24: удалён <code>glbviewer</code>.
- 2025-02-01: выполнена адаптация к новому API и переход на Preview 3D.
- 2024-11-11: выполнена адаптация к новому API.
- 2024-10-14: добавлена конвертация моделей.
- 2024-09-13: добавлена поддержка <code>model_version</code> <code>v2.0-20240919</code>.

## Установка

Официальные инструменты: [ComfyUI-Manager](https://github.com/ltdrdata/ComfyUI-Manager), [Comfy Registry](https://registry.comfy.org/) и [comfy-cli](https://github.com/Comfy-Org/comfy-cli).

**Выберите один способ** и перезапустите ComfyUI.

1. **ComfyUI-Manager:** Найдите <code>Tripo for ComfyUI</code> в Custom Nodes Manager и установите.
2. **comfy-cli:**

~~~bash
comfy node registry-install comfyui-tripo
~~~

3. **Из исходников:**

~~~bash
cd ComfyUI/custom_nodes
git clone https://github.com/VAST-AI-Research/ComfyUI-Tripo.git
python -m pip install -r ComfyUI-Tripo/requirements.txt
~~~

## Настройка API Key

Сначала создайте API Key на [платформе Tripo](https://platform.tripo3d.ai/), затем настройте его одним из способов ниже.

Ключ определяется в следующем порядке:

1. Непустой ввод <code>apikey</code> в узле.
2. Переменная окружения <code>TRIPO_API_KEY</code>.
3. Поле <code>TRIPO_API_KEY</code> в <code>config.json</code> каталога проекта.

Generate и Import предоставляют <code>apikey</code>; последующие узлы получают ключ через <code>MODEL_INFO</code>. Не публикуйте реальный ключ в снимках, workflow, журналах или репозиториях.

### Примеры запуска с переменной окружения

Windows:

~~~shell
set TRIPO_API_KEY=tsk_XXXXXXX
python.exe main.py [--cpu]
~~~

Linux или macOS:

~~~bash
TRIPO_API_KEY=tsk_XXXXXXX python main.py [--cpu]
~~~

## Обзор узлов

ComfyUI-Tripo предоставляет следующие 11 узлов Tripo:

| Внутренний ID | Имя в интерфейсе | Возможность | Выход |
| --- | --- | --- | --- |
| <code>TripoAPIDraft</code> | Tripo: Generate model | Генерирует модель из текста, изображения или нескольких видов. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoImportModel</code> | Tripo: Import model | Импортирует локальную модель или URL. | <code>MODEL_INFO</code> |
| <code>TripoTextureModel</code> | Tripo: Texture model | Создаёт текстуру модели. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoRefineModel</code> | Tripo: Refine Draft model | Уточняет совместимый черновик. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoMeshSegmentation</code> | Tripo: Segment mesh | Сегментирует сетку. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoMeshCompletion</code> | Tripo: Complete mesh | Дополняет сегментированную сетку. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoSmartLowPoly</code> | Tripo: Smart low poly | Создаёт low-poly модель. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoStylizeModel</code> | Tripo: Stylize model | Применяет геометрический стиль. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoAnimateRigNode</code> | Tripo: Rig model | Автоматически создаёт риг. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoAnimateRetargetNode</code> | Tripo: Retarget rigged model | Применяет готовую анимацию. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoConvertNode</code> | Tripo: Convert model | Конвертирует и экспортирует модель. | STRING <code>model_file</code> |

Preview 3D предоставляется ComfyUI и не входит в 11 узлов Tripo.

## Соединения и поток данных

~~~mermaid
flowchart LR
    G["Generate model"] -->|MODEL_INFO| P["Обработка модели"]
    I["Import model"] -->|MODEL_INFO| P
    P -->|MODEL_INFO| R["Rig model"]
    R -->|MODEL_INFO| A["Retarget rigged model"]
    A -->|MODEL_INFO| C["Convert model"]
~~~

- <code>model_file</code> — путь к загруженному файлу для предпросмотра или файловой обработки.
- <code>MODEL_INFO</code> содержит <code>task_id</code>, определённый <code>apikey</code>, <code>file_prefix</code> и <code>output_directory</code>.
- Внешняя модель должна сначала пройти через <code>TripoImportModel</code>; путь к файлу не заменяет <code>MODEL_INFO</code>.
- Для дальнейшей обработки Tripo соединяйте <code>MODEL_INFO</code>.

## Полный справочник узлов

«Обязательно» обозначает входы, обязательные в определении узла. Пустой <code>apikey</code> может использовать окружение или конфигурацию. Тире означает, что явное значение по умолчанию не задано.

### Генерация и импорт

### TripoAPIDraft — Tripo: Generate model

Генерирует модель из текста, изображения или нескольких видов.

| Вход | Тип | Обязательно | По умолчанию | Значения / диапазон |
| --- | --- | --- | --- | --- |
| <code>mode</code> | ENUM | Да | первое значение | <code>text_to_model</code>, <code>image_to_model</code>, <code>multiview_to_model</code> |
| <code>apikey</code> | STRING | Да | пусто | API key или резервная настройка |
| <code>prompt</code> | STRING multiline | Нет | пусто | <code>text_to_model</code> |
| <code>negative_prompt</code> | STRING multiline | Нет | пусто | — |
| <code>image</code> | IMAGE | Нет | — | <code>image_to_model</code> источник; <code>multiview_to_model</code> вид спереди |
| <code>image_left</code> | IMAGE | Нет | — | <code>multiview_to_model</code> |
| <code>image_back</code> | IMAGE | Нет | — | <code>multiview_to_model</code> |
| <code>image_right</code> | IMAGE | Нет | — | <code>multiview_to_model</code> |
| <code>model_version</code> | ENUM | Нет | <code>v3.1-20260211</code> | <code>v1.4-20240625</code>, <code>v2.0-20240919</code>, <code>v2.5-20250123</code>, <code>v3.0-20250812</code>, <code>v3.1-20260211</code> |
| <code>texture</code> | BOOLEAN | Нет | <code>true</code> | — |
| <code>pbr</code> | BOOLEAN | Нет | <code>true</code> | — |
| <code>image_seed</code> | INT | Нет | <code>42</code> | <code>text_to_model</code> |
| <code>model_seed</code> | INT | Нет | <code>42</code> | — |
| <code>texture_seed</code> | INT | Нет | <code>42</code> | — |
| <code>texture_quality</code> | ENUM | Нет | <code>standard</code> | <code>standard</code>, <code>detailed</code> |
| <code>geometry_quality</code> | ENUM | Нет | <code>standard</code> | <code>standard</code>, <code>detailed</code>; <code>image_to_model</code> |
| <code>texture_alignment</code> | ENUM | Нет | <code>original_image</code> | <code>original_image</code>, <code>geometry</code> |
| <code>face_limit</code> | INT | Нет | <code>-1</code> | <code>-1</code>–<code>500000</code>; ≤ 0 считается не заданным |
| <code>quad</code> | BOOLEAN | Нет | <code>false</code> | — |
| <code>compress</code> | BOOLEAN | Нет | <code>false</code> | — |
| <code>generate_parts</code> | BOOLEAN | Нет | <code>false</code> | — |
| <code>smart_low_poly</code> | BOOLEAN | Нет | <code>false</code> | — |
| <code>auto_size</code> | BOOLEAN | Нет | <code>false</code> | — |
| <code>orientation</code> | ENUM | Нет | <code>default</code> | <code>default</code>, <code>align_image</code>; режимы image/multiview |
| <code>file_prefix</code> | STRING | Нет | пусто | — |
| <code>output_directory</code> | STRING | Нет | пусто | — |

**Выход:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Предусловие:** нет. **Частые ошибки:** нет условного входа/ключа, ошибка API или перемещения результата. **Минимальное соединение:** Текст/изображение → <code>TripoAPIDraft</code> → Preview 3D.

Три режима имеют следующие условно обязательные входы:

| <code>mode</code> | Условно обязательно | Примечание |
| --- | --- | --- |
| <code>text_to_model</code> | <code>prompt</code> | <code>prompt</code> не может быть пустым. |
| <code>image_to_model</code> | <code>image</code> | Требуется <code>image</code>. |
| <code>multiview_to_model</code> | <code>image</code> | <code>image</code> — вид спереди; слева, сзади и справа необязательны. |

### TripoImportModel — Tripo: Import model

Импортирует локальную модель или URL.

| Вход | Тип | Обязательно | По умолчанию | Значения / диапазон |
| --- | --- | --- | --- | --- |
| <code>apikey</code> | STRING | Да | пусто | API key или резервная настройка |
| <code>model_file</code> | file selector | Нет | <code>none</code> | каталог input ComfyUI |
| <code>model_url</code> | STRING | Нет | пусто | прямой URL |
| <code>file_prefix</code> | STRING | Нет | пусто | передаётся дальше |
| <code>output_directory</code> | STRING | Нет | пусто | передаётся дальше |

**Выход:** <code>MODEL_INFO</code>. **Предусловие:** локальный файл или URL. **Частые ошибки:** нет источника/доступа, формат отклонён или import не выполнен. **Минимальное соединение:** локальный файл или URL → <code>TripoImportModel</code> → MODEL_INFO.

Непустой <code>model_url</code> имеет приоритет над <code>model_file</code>. Без обоих узел завершится ошибкой. Загрузка принимает <code>.glb</code>, <code>.fbx</code>, <code>.obj</code>, <code>.stl</code>, <code>.ply</code>, <code>.3mf</code> и <code>.gltf</code>; backend также распознаёт <code>.zip</code>.

### Обработка модели

### TripoTextureModel — Tripo: Texture model

Создаёт текстуру модели.

| Вход | Тип | Обязательно | По умолчанию | Значения / диапазон |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Да | — | контекст предыдущей задачи |
| <code>model_version</code> | ENUM | Нет | <code>v3.0-20250812</code> | <code>v2.5-20250123</code>, <code>v3.0-20250812</code> |
| <code>texture</code> | BOOLEAN | Нет | <code>true</code> | — |
| <code>pbr</code> | BOOLEAN | Нет | <code>true</code> | — |
| <code>texture_seed</code> | INT | Нет | <code>42</code> | — |
| <code>texture_quality</code> | ENUM | Нет | <code>standard</code> | <code>standard</code>, <code>detailed</code> |
| <code>texture_alignment</code> | ENUM | Нет | <code>original_image</code> | <code>original_image</code>, <code>geometry</code> |
| <code>text_prompt</code> | STRING multiline | Нет | пусто | — |
| <code>image_prompt</code> | IMAGE | Нет | — | — |
| <code>style_image</code> | IMAGE | Нет | — | — |
| <code>part_names</code> | STRING multiline | Нет | пусто | одно имя части в строке |
| <code>compress</code> | BOOLEAN | Нет | <code>false</code> | — |
| <code>bake</code> | BOOLEAN | Нет | <code>true</code> | — |

**Выход:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Предусловие:** Generate / Import MODEL_INFO. **Частые ошибки:** несовместимый контекст, неверное изображение или ошибка API. **Минимальное соединение:** Generate / Import → <code>TripoTextureModel</code> → Preview 3D.

### TripoRefineModel — Tripo: Refine Draft model

Уточняет совместимый черновик.

| Вход | Тип | Обязательно | По умолчанию | Значения / диапазон |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Да | — | контекст черновика |

**Выход:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Предусловие:** MODEL_INFO подходящего черновика. **Частые ошибки:** неподходящий черновик или ошибка API. **Минимальное соединение:** Generate draft → <code>TripoRefineModel</code> → Preview 3D.

### TripoMeshSegmentation — Tripo: Segment mesh

Сегментирует сетку.

| Вход | Тип | Обязательно | По умолчанию | Значения / диапазон |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Да | — | контекст предыдущей задачи |
| <code>model_version</code> | ENUM | Да | <code>v1.0-20250506</code> | <code>v1.0-20250506</code>, <code>v2.0-20260430</code> |
| <code>segmentation_granularity</code> | ENUM | Нет | <code>balanced</code> | <code>simple</code>, <code>balanced</code>, <code>detailed</code>; v2 only |
| <code>ref_image</code> | IMAGE | Нет | — | только v2 |
| <code>split_by_connectivity</code> | BOOLEAN | Нет | <code>true</code> | только v2 |

**Выход:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Предусловие:** Generate / Import MODEL_INFO. **Частые ошибки:** несовместимая модель/ссылка или ошибка API. **Минимальное соединение:** Generate / Import → <code>TripoMeshSegmentation</code> → Completion / Preview.

<code>segmentation_granularity</code>, <code>ref_image</code> и <code>split_by_connectivity</code> передаются только для <code>v2.0-20260430</code>; v1 их игнорирует.

### TripoMeshCompletion — Tripo: Complete mesh

Дополняет сегментированную сетку.

| Вход | Тип | Обязательно | По умолчанию | Значения / диапазон |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Да | — | контекст сегментации |
| <code>model_version</code> | ENUM | Да | <code>v1.0-20250506</code> | <code>v1.0-20250506</code> |
| <code>part_names</code> | STRING multiline | Нет | пусто | одно имя части в строке |

**Выход:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Предусловие:** сегментированный MODEL_INFO. **Частые ошибки:** задача не подходит для дополнения или ошибка API. **Минимальное соединение:** Segment → <code>TripoMeshCompletion</code> → Preview 3D.

### TripoSmartLowPoly — Tripo: Smart low poly

Создаёт low-poly модель.

| Вход | Тип | Обязательно | По умолчанию | Значения / диапазон |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Да | — | контекст предыдущей задачи |
| <code>model_version</code> | ENUM | Да | <code>P-v2.0-20251225</code> | <code>P-v2.0-20251225</code> |
| <code>quad</code> | BOOLEAN | Нет | <code>false</code> | — |
| <code>part_names</code> | STRING multiline | Нет | пусто | одно имя части в строке |
| <code>face_limit</code> | INT | Нет | <code>10000</code> | <code>-1</code>–<code>20000</code> |
| <code>bake</code> | BOOLEAN | Нет | <code>true</code> | — |

**Выход:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Предусловие:** Generate / Import MODEL_INFO. **Частые ошибки:** несовместимая модель/части или ошибка API. **Минимальное соединение:** Generate / Import → <code>TripoSmartLowPoly</code> → Preview / Convert.

### TripoStylizeModel — Tripo: Stylize model

Применяет геометрический стиль.

| Вход | Тип | Обязательно | По умолчанию | Значения / диапазон |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Да | — | контекст предыдущей задачи |
| <code>style</code> | ENUM | Да | первое значение | <code>lego</code>, <code>voxel</code>, <code>voronoi</code>, <code>minecraft</code> |
| <code>block_size</code> | INT | Да | <code>80</code> | <code>1</code>–<code>1000</code> |

**Выход:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Предусловие:** Generate / Import MODEL_INFO. **Частые ошибки:** несовместимая модель/стиль или ошибка API. **Минимальное соединение:** Generate / Import → <code>TripoStylizeModel</code> → Preview 3D.

### Риг и анимация

### TripoAnimateRigNode — Tripo: Rig model

Автоматически создаёт риг.

| Вход | Тип | Обязательно | По умолчанию | Значения / диапазон |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Да | — | контекст предыдущей задачи |
| <code>model_version</code> | ENUM | Да | <code>v2.0-20250506</code> | <code>v1.0-20240301</code>, <code>v2.0-20250506</code> |
| <code>out_format</code> | ENUM | Да | <code>glb</code> | <code>glb</code>, <code>fbx</code> |
| <code>spec</code> | ENUM | Да | <code>tripo</code> | <code>mixamo</code>, <code>tripo</code> |

**Выход:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Предусловие:** Generate / Import MODEL_INFO. **Частые ошибки:** модель нельзя риггировать, нет rig type или ошибка API. **Минимальное соединение:** Generate / Import → <code>TripoAnimateRigNode</code> → Retarget / Preview.

Перед ригом узел проверяет модель и получает rig type.

### TripoAnimateRetargetNode — Tripo: Retarget rigged model

Применяет готовую анимацию.

| Вход | Тип | Обязательно | По умолчанию | Значения / диапазон |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Да | — | контекст рига |
| <code>animation</code> | ENUM | Да | первое значение | 16 пресетов ниже |
| <code>out_format</code> | ENUM | Да | <code>glb</code> | <code>glb</code>, <code>fbx</code> |
| <code>bake_animation</code> | BOOLEAN | Нет | <code>true</code> | — |
| <code>export_with_geometry</code> | BOOLEAN | Нет | <code>false</code> | — |

**Выход:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Предусловие:** MODEL_INFO с ригом. **Частые ошибки:** контекст без рига или ошибка API. **Минимальное соединение:** Rig → <code>TripoAnimateRetargetNode</code> → Preview / Convert.

16 значений анимации: <code>preset:idle</code>, <code>preset:walk</code>, <code>preset:run</code>, <code>preset:dive</code>, <code>preset:climb</code>, <code>preset:jump</code>, <code>preset:slash</code>, <code>preset:shoot</code>, <code>preset:hurt</code>, <code>preset:fall</code>, <code>preset:turn</code>, <code>preset:quadruped:walk</code>, <code>preset:hexapod:walk</code>, <code>preset:octopod:walk</code>, <code>preset:serpentine:march</code>, <code>preset:aquatic:march</code>.

### Формат вывода

### TripoConvertNode — Tripo: Convert model

Конвертирует и экспортирует модель.

| Вход | Тип | Обязательно | По умолчанию | Значения / диапазон |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Да | — | контекст предыдущей задачи |
| <code>format</code> | ENUM | Да | первое значение | <code>GLTF</code>, <code>USDZ</code>, <code>FBX</code>, <code>OBJ</code>, <code>STL</code>, <code>3MF</code> |
| <code>quad</code> | BOOLEAN | Нет | <code>false</code> | — |
| <code>force_symmetry</code> | BOOLEAN | Нет | <code>false</code> | — |
| <code>face_limit</code> | INT | Нет | <code>-1</code> | <code>-1</code>–<code>500000</code> |
| <code>flatten_bottom</code> | BOOLEAN | Нет | <code>false</code> | — |
| <code>flatten_bottom_threshold</code> | FLOAT | Нет | <code>0.01</code> | <code>0.0</code>–<code>1.0</code> |
| <code>texture_size</code> | INT | Нет | <code>4096</code> | <code>128</code>–<code>4096</code> |
| <code>texture_format</code> | ENUM | Нет | <code>JPEG</code> | <code>BMP</code>, <code>DPX</code>, <code>HDR</code>, <code>JPEG</code>, <code>OPEN_EXR</code>, <code>PNG</code>, <code>TARGA</code>, <code>TIFF</code>, <code>WEBP</code> |
| <code>pivot_to_center_bottom</code> | BOOLEAN | Нет | <code>false</code> | — |
| <code>scale_factor</code> | FLOAT | Нет | <code>1.0</code> | минимум <code>0</code> |
| <code>with_animation</code> | BOOLEAN | Нет | <code>true</code> | — |
| <code>pack_uv</code> | BOOLEAN | Нет | <code>false</code> | — |
| <code>bake</code> | BOOLEAN | Нет | <code>true</code> | — |
| <code>part_names</code> | STRING multiline | Нет | пусто | одно имя части в строке |
| <code>fbx_preset</code> | ENUM | Нет | <code>blender</code> | <code>blender</code>, <code>mixamo</code>, <code>3dsmax</code> |
| <code>export_vertex_colors</code> | BOOLEAN | Нет | <code>false</code> | — |
| <code>export_orientation</code> | ENUM | Нет | <code>+x</code> | <code>+x</code>, <code>+y</code>, <code>-x</code>, <code>-y</code> |
| <code>animate_in_place</code> | BOOLEAN | Нет | <code>false</code> | — |

**Выход:** STRING <code>model_file</code>. **Предусловие:** совместимый MODEL_INFO. **Частые ошибки:** конвертация не поддерживается, неверные настройки или ошибка вывода. **Минимальное соединение:** MODEL_INFO → <code>TripoConvertNode</code>.

Convert — выходной узел и не возвращает <code>MODEL_INFO</code>.

## Примеры workflow

Preview 3D — необязательный просмотрщик ComfyUI.

~~~mermaid
flowchart LR
    T["Текст"] --> GT["Generate model<br/>mode: text_to_model"]
    IM["Изображение"] --> GI["Generate model<br/>mode: image_to_model"]
    MV["Вид спереди + необязательные виды"] --> GM["Generate model<br/>mode: multiview_to_model"]
    GT --> V["Preview 3D"]
    GI --> V
    GM --> V
~~~

1. **Text to Model:** <code>prompt</code> → Generate с <code>text_to_model</code> → Preview 3D.
2. **Image to Model:** IMAGE → <code>image</code>, режим <code>image_to_model</code> → Preview 3D.
3. **Multiview to Model:** передний вид в <code>image</code>, остальные в <code>image_left</code>, <code>image_back</code>, <code>image_right</code>.
4. **Texture Model:** Generate/Import → MODEL_INFO → Texture → Preview.
5. **Refine Model:** совместимый черновик → MODEL_INFO → Refine → Preview.
6. **Rig and Retarget:** Generate/Import → Rig → Retarget, соединяя MODEL_INFO.
7. **Import and Process:** файл/URL → Import → Segment/Smart low poly/Stylize/Texture.
8. **Convert and Export:** итоговый MODEL_INFO → Convert → формат.

### Официальные PNG workflow

Следующие шесть PNG содержат встроенные данные workflow ComfyUI. Сохраните оригинал по ссылке, затем перетащите его в ComfyUI или загрузите вручную. Значения параметров на изображениях приведены только как примеры; актуальные значения по умолчанию указаны в таблицах параметров.

#### Text to Mesh

![Workflow текст-в-меш с Tripo Generate model и Preview 3D](/assets/images/docs/comfyui-nodes/text_to_model.png)

Создаёт модель по тексту и передаёт <code>model_file</code> в Preview 3D.

<a href="/assets/images/docs/comfyui-nodes/text_to_model.png" download>Скачать оригинальный PNG workflow</a>

#### Image to Mesh

![Workflow изображение-в-меш с Load Image, Tripo Generate model и Preview 3D](/assets/images/docs/comfyui-nodes/image_to_model.png)

Загружает изображение, подключает его к Generate model в режиме <code>image_to_model</code> и показывает результат.

<a href="/assets/images/docs/comfyui-nodes/image_to_model.png" download>Скачать оригинальный PNG workflow</a>

#### Multiview Images to Mesh

![Многовидовой workflow с тремя Load Image, Tripo Generate model и Preview 3D](/assets/images/docs/comfyui-nodes/multiview_to_model.png)

Подключает фронтальный и дополнительные боковые виды к Generate model в режиме <code>multiview_to_model</code>.

<a href="/assets/images/docs/comfyui-nodes/multiview_to_model.png" download>Скачать оригинальный PNG workflow</a>

#### Texture a generated model

![Workflow текстурирования с Generate model, Texture model и Preview 3D](/assets/images/docs/comfyui-nodes/texture_model.png)

Передаёт <code>MODEL_INFO</code> из Generate model в Texture model и показывает оба результата.

<a href="/assets/images/docs/comfyui-nodes/texture_model.png" download>Скачать оригинальный PNG workflow</a>

#### Refine a draft Mesh

![Workflow уточнения с Generate model, Refine Draft model и Preview 3D](/assets/images/docs/comfyui-nodes/refine_model.png)

Создаёт совместимый черновик, передаёт <code>MODEL_INFO</code> в Refine Draft model и показывает результат.

<a href="/assets/images/docs/comfyui-nodes/refine_model.png" download>Скачать оригинальный PNG workflow</a>

#### Animation / Rig and export

![Workflow риггинга и экспорта с Generate model, Rig model, Preview 3D и Convert model](/assets/images/docs/comfyui-nodes/retarget.png)

<a href="/assets/images/docs/comfyui-nodes/retarget.png" download>Скачать оригинальный PNG workflow</a>

## Вывод и устранение неполадок

По умолчанию файлы загружаются в <code>ComfyUI/output</code>. <code>file_prefix</code> меняет имя, а <code>output_directory</code> перемещает файл; оба значения передаются в <code>MODEL_INFO</code>.

| Симптом | Проверка |
| --- | --- |
| Нет API Key | Задайте ключ узла, <code>TRIPO_API_KEY</code> или <code>config.json</code>. |
| Нет prompt/вида спереди | Проверьте режим и условный вход. |
| Import не запускается | Укажите доступный URL или существующий файл; URL приоритетен. |
| Модель нельзя риггировать | Используйте подходящую модель персонажа. |
| Ошибка задачи API | Проверьте <code>error_code</code>, <code>error_msg</code>, доступ и баланс. |
| Нельзя переместить результат | Проверьте путь и права записи. |
| Узлы не появились | Перезапустите ComfyUI, проверьте каталог и <code>requirements.txt</code>. |
| Ошибка загрузки | Проверьте расширение и ответ загрузки ComfyUI. |