# Плагины Tripo Используйте Tripo непосредственно в инструментах, в которых вы уже создаёте 3D-контент. Выберите плагин для своего рабочего процесса, скачайте его, подключите API-ключ Tripo и создавайте модели, не покидая редактор. ## Поддерживаемые плагины | Плагин | Версия Tripo | Совместимая версия | Лучше всего подходит для | Скачать | | ------------- | ------------ | ------------------ | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- | | Unity | `1.0.1` | `Unity 2022+` | Создания и импорта игровых ресурсов | Скачать | | Unreal Engine | `1.0` | `5.6.0` | Работы в редакторе и с Blueprint | Скачать | | Blender | `0.7.3` | `3.0+` | Создания базовой модели для дальнейшего редактирования | Скачать | | Godot | `0.02` | `4.4+` | Работы в редакторе и с `Node3D` | Скачать | | Cocos Creator | `1.0.0` | `3.8.6+` | Создания ресурсов внутри проекта Cocos | Скачать | | ComfyUI | `1.1.21` | `0.3.14` | Процессов 3D-генерации на основе узлов | Скачать | Каждый плагин предоставляет свой набор функций Tripo. В примерах ниже описано только поведение, доступное в соответствующем пакете. ## Примеры использования плагинов ### Unity — Создание игрового объекта **Сценарий.** Создайте заполнитель или основу для будущей рабочей модели при прототипировании сцены. **Шаги.** 1. Откройте `Tools > Tripo API Unity` и настройте свой API-ключ. 2. Выберите **Image to Model**, загрузите изображение и запустите генерацию. 3. Дождитесь завершения задачи и позвольте плагину импортировать скачанную модель в проект. Для дополнительного локального сценария выполнения **Text to Model** пакет также предоставляет `TripoRuntimeCore`: ```csharp GetComponent() .SetAPIKey("") .SetTextPrompt("a stylized wooden treasure chest") .TextToModel(); ``` **Результат.** Созданный ресурс доступен в Unity для настройки материалов, размещения в сцене или дальнейшего редактирования. Скачать ### Unreal Engine — Генерация с помощью Blueprint **Сценарий.** Добавьте генерацию моделей в инструмент редактора Unreal или прототип на основе Blueprint. **Шаги.** 1. Создайте задачу генерации по тексту, изображению или нескольким ракурсам с помощью узлов Blueprint плагина. 2. Используйте узлы обратного вызова и статуса задачи, чтобы дождаться её завершения. 3. Передайте полученный URL-адрес модели узлу скачивания. Для отображения во время выполнения требуется отдельный плагин glTFRuntime, описанный в документации пакета. ![Узлы Blueprint Unreal Engine для создания, проверки и скачивания моделей Tripo](/assets/images/docs/plugins/unreal-blueprint.jpg) **Результат.** Созданную модель можно скачать для импорта в редактор или передать в рабочий процесс отображения во время выполнения. Скачать ### Blender — Генерация по референсному изображению **Сценарий.** Создайте базовую сетку по изображению, а затем продолжите моделирование и работу с материалами в Blender. **Шаги.** 1. Откройте `View3D > Sidebar > Tripo 3D` и подключите свой API-ключ. 2. Выберите генерацию модели по изображению, укажите референсное изображение и настройте такие параметры, как лимит граней, текстуры, PBR или четырёхугольная сетка. 3. Запустите генерацию и дождитесь, пока плагин скачает и импортирует результат. **Результат.** Файл GLB или FBX импортируется в Blender, где его можно редактировать стандартными инструментами моделирования. Скачать ### Godot — Добавление созданной модели как Node3D **Сценарий.** Создайте 3D-объект в редакторе Godot или локальном рабочем процессе среды выполнения и добавьте его в дерево сцены. **Шаги.** Настройте API-ключ в плагине, создайте узел входных данных и узел задачи, затем дождитесь завершения задачи: В примере ниже используется текстовая задача. Для задачи по изображению загрузите исходник через `TripoUploadImage`, а затем создайте модель с помощью `TripoImageToModel`. ```gdscript var input = TripoTextToModelInput.new() input.prompt = "a stylized wooden treasure chest" var task = TripoTextToModel.new() task.input = input add_child(task) if await task.launch() == TripoTask.TaskError.eSuccess: add_child(task.save_to_node()) ``` **Результат.** Созданную модель можно просмотреть, сохранить или добавить в текущую сцену как `Node3D`. Скачать ### Cocos Creator — Сохранение созданного ресурса проекта **Сценарий.** Создайте модель по тексту или изображению, не покидая Cocos Creator. **Шаги.** 1. Откройте панель **Tripo Model Generator** и подключите свой API-ключ. 2. Выберите ввод текста или изображения, настройте параметры генерации и запустите задачу. 3. Дождитесь, пока расширение скачает готовую модель в проект. **Результат.** Файл GLB или FBX сохраняется в `assets/resources` и становится доступен в текущем проекте. Скачать ### ComfyUI — Создание рабочего процесса «текст в 3D» **Сценарий.** Подключите генерацию Tripo к существующему процессу обработки изображений или ресурсов на основе узлов. **Шаги.** 1. Подключите текстовый ввод к узлу генерации модели Tripo. 2. Задайте API-ключ, режим генерации, версию модели и параметры вывода. 3. Подключите результат к узлу предпросмотра 3D и запустите очередь. ![Рабочий процесс ComfyUI «текст в 3D» с предпросмотром созданной модели](/assets/images/docs/plugins/comfyui-text-to-model.jpg) **Результат.** Модель отображается в рабочем процессе и автоматически сохраняется в `ComfyUI/output`. Скачать ## Установка и начало работы ### Unity 1. Скачайте и распакуйте ZIP-файл. 2. Переместите распакованный каталог плагина, содержащий `package.json`, в каталог `Packages` своего проекта. 3. Снова откройте проект и выберите `Tools > Tripo API Unity`. ### Unreal Engine 1. Скачайте и распакуйте ZIP-файл в `Plugins/Tripo3D` своего проекта Unreal. 2. Включите плагин в настройках проекта. 3. Перезапустите Unreal Editor. ### Blender 1. Откройте `Edit > Preferences > Add-ons`. 2. Выберите **Install from Disk**, укажите скачанный ZIP-файл и включите **Tripo 3D**. 3. Откройте плагин через `View3D > Sidebar > Tripo 3D`. ### Godot 1. Распакуйте ZIP-файл и скопируйте `addons/tripo-godot` в каталог `addons` своего проекта. 2. Откройте `Project Settings > Plugins` и включите плагин Tripo. 3. Откройте панель Tripo в редакторе или используйте предоставленные узлы в сцене. ### Cocos Creator 1. Откройте `Extension > Extension Manager`. 2. Выберите **Project** или **Global**, нажмите `+` и импортируйте скачанный ZIP-файл. 3. Включите расширение, затем откройте панель **Tripo Model Generator**. Стандартный порядок импорта ZIP-файла приведён в [руководстве по установке расширений Cocos Creator 3.8](https://docs.cocos.com/creator/3.8/manual/en/editor/extension/install.html). ### ComfyUI 1. Распакуйте ZIP-файл в `ComfyUI/custom_nodes/ComfyUI-Tripo`. 2. Установите зависимости из среды Python ComfyUI: ```bash python -m pip install -r ComfyUI/custom_nodes/ComfyUI-Tripo/requirements.txt ``` 3. Перезапустите ComfyUI и загрузите или создайте рабочий процесс Tripo. ## Настройка API-ключа Создайте ключ на [странице API-ключей Tripo](https://platform.tripo3d.ai/api-keys), затем введите его в выбранном плагине перед запуском задачи. API-ключ — это секретные учётные данные. Не добавляйте его в систему контроля версий, не показывайте на снимках экрана, не выводите в журналы и не включайте в общедоступную клиентскую сборку. Общие правила API приведены в разделе [Аутентификация](/ru/docs/authentication). ## Связанные ресурсы - [Аутентификация](/ru/docs/authentication) - [Интеграция SDK](/ru/docs/sdk) - [API-ключи Tripo](https://platform.tripo3d.ai/api-keys)