# Узлы 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  Создаёт модель по тексту и передаёт <code>model_file</code> в Preview 3D. <a href="/assets/images/docs/comfyui-nodes/text_to_model.png" download>Скачать оригинальный PNG workflow</a> #### Image to Mesh  Загружает изображение, подключает его к 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  Подключает фронтальный и дополнительные боковые виды к 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  Передаёт <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  Создаёт совместимый черновик, передаёт <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  <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. |

comfy node registry-install comfyui-tripo

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

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

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

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"]

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