# ComfyUI-Rodin 插件完整入门教程 ## 1. 插件简介 ComfyUI-Rodin 是一个让你在 ComfyUI 里玩转 3D 模型生成的神器插件！就像给你的 ComfyUI 装了个 3D 打印机一样，可以把图片、文字直接变成立体的 3D 模型。 **GitHub 原地址：** https://github.com/Ravenmelt/ComfyUI-Rodin **这个插件能干什么？** - 把一张图片变成 3D 模型（就像把照片变成雕塑） - 用文字描述生成 3D 模型（比如输入"一只可爱的小猫"就能得到 3D 小猫） - 用多张图片合成一个 3D 模型（从不同角度拍的照片合成立体模型） - 在 ComfyUI 里直接预览 3D 模型（不用打开其他软件就能看效果） **效果就像：** 原本你只能做平面图像，现在可以做立体的、可以旋转查看的 3D 模型了！ ## 2. 如何安装 ### 方法一：ComfyUI 管理器安装（推荐新手） 1. 打开 ComfyUI 管理器 2. 搜索 "ComfyUI-Rodin" 3. 点击安装 4. 重启 ComfyUI ### 方法二：手动安装 1. 找到你的 ComfyUI 文件夹 2. 进入 `custom_nodes` 文件夹 3. 打开命令行，输入：`git clone https://github.com/Ravenmelt/ComfyUI-Rodin.git` 4. 重启 ComfyUI **重要提醒：** 使用前需要去 https://hyperhuman.deemos.com/api-dashboard 获取 API 密钥，就像办会员卡一样！ ## 3. 节点逐一解析 ### 3.1 LoadRodinAPIKEY 节点 - API 密钥管理器 这个节点就像你的会员卡管理器，负责保存和管理你的 Rodin API 密钥。 **参数详解：** | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | API Key | api_key | 文本字符串 | 你的真实API密钥 | 就像你的会员卡号码，用来证明你有权限使用 3D 生成服务 | 用于向 Rodin API 服务认证身份的唯一标识符 | 去官网申请后，把获得的一串字符粘贴到这里 | ### 3.2 RodinImageTo3D 节点 - 图片变 3D 魔法师 这个节点就像一个魔法师，能把你的平面图片变成立体的 3D 模型。 **参数详解：** | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | Image | image | 图片文件 | 清晰的单个物体图片 | 要变成 3D 的原始图片，就像雕塑师的参考照片 | 作为 3D 重建输入的源图像数据 | 上传一张苹果的照片，就能生成 3D 苹果模型 | | API Key | api_key | 文本字符串 | 从 LoadRodinAPIKEY 节点连接 | 你的服务权限证明，就像进游乐园的门票 | 用于 API 认证的密钥字符串 | 连接上面的 API Key 节点 | | Texture Type | texture_type | 选择项 | "PBR" 或 "Shaded" | 材质类型选择，PBR 更真实，Shaded 更卡通 | 定义 3D 模型表面材质渲染方式 | 做游戏道具选 PBR，做卡通角色选 Shaded | | Quality | quality | 选择项 | "High" | 生成质量等级，像手机拍照的清晰度设置 | 控制 3D 模型生成的精度和细节程度 | 重要物体选 High，预览用可选 Medium | ### 3.3 RodinTextTo3D 节点 - 文字变 3D 造梦师 这个节点就像一个造梦师，你用文字描述什么，它就能变出什么 3D 模型。 **参数详解：** | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | Prompt | prompt | 文本描述 | 详细的英文描述 | 你想要的 3D 模型描述，越详细越好 | 用于指导 3D 模型生成的文本提示词 | "A red apple on a wooden table" | | API Key | api_key | 文本字符串 | 从 LoadRodinAPIKEY 节点连接 | 你的服务权限证明，就像图书馆借书证 | 用于 API 认证的密钥字符串 | 连接 API Key 节点 | | Texture Type | texture_type | 选择项 | "PBR" 或 "Shaded" | 材质风格选择，PBR 像照片，Shaded 像手绘 | 定义 3D 模型表面材质渲染方式 | 做建筑模型选 PBR，做动漫角色选 Shaded | | Quality | quality | 选择项 | "High" | 生成精细度，像打印机的打印质量设置 | 控制 3D 模型生成的精度和细节程度 | 最终成品选 High，快速预览选 Medium | | Negative Prompt | negative_prompt | 文本描述 | 不想要的特征 | 告诉系统你不想要什么，避免生成错误的东西 | 用于排除不希望出现在 3D 模型中的特征 | "blurry, low quality, broken" | ### 3.4 RodinMultiImageTo3D 节点 - 多视角 3D 合成师 这个节点就像一个全方位的摄影师，能把你从不同角度拍的照片合成一个完整的 3D 模型。 **参数详解：** | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | Images | images | 多张图片 | 2-6张不同角度的图片 | 同一个物体的多个角度照片，就像拍证件照要正面和侧面 | 用于多视角 3D 重建的输入图像序列 | 一个苹果的正面、侧面、背面照片 | | API Key | api_key | 文本字符串 | 从 LoadRodinAPIKEY 节点连接 | 你的服务使用凭证，就像健身房的会员卡 | 用于 API 认证的密钥字符串 | 连接 API Key 节点 | | Texture Type | texture_type | 选择项 | "PBR" 或 "Shaded" | 表面材质类型，PBR 更接近真实，Shaded 更有艺术感 | 定义 3D 模型表面材质渲染方式 | 扫描真实物品选 PBR，制作艺术品选 Shaded | | Quality | quality | 选择项 | "High" | 最终模型的精细程度，像相机的像素设置 | 控制 3D 模型生成的精度和细节程度 | 用于 3D 打印选 High，网页展示选 Medium | ### 3.5 RodinPreview3D 节点 - 3D 模型预览器 这个节点就像一个 3D 展示台，让你在 ComfyUI 里直接查看和旋转 3D 模型。 **参数详解：** | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 3D Model | model_path | 文件路径 | 生成的 3D 模型文件 | 要预览的 3D 模型，就像相册里的照片 | 指向 3D 模型文件的路径引用 | 连接上面任意一个 3D 生成节点的输出 | | Background Color | bg_color | 颜色值 | 白色或透明 | 展示背景颜色，像展示台的背景布 | 3D 预览窗口的背景色设置 | 白色背景看得更清楚，透明背景更专业 | | Rotation Speed | rotation_speed | 数值 | 0.5-2.0 | 自动旋转的速度，像音乐盒转动的快慢 | 控制 3D 模型自动旋转的角速度 | 1.0 是正常速度，2.0 是两倍速 | | Zoom Level | zoom_level | 数值 | 1.0-3.0 | 放大倍数，像放大镜的倍数 | 控制 3D 模型在预览窗口中的缩放比例 | 1.0 是原始大小，2.0 是两倍大 | ## 4. 使用技巧和建议 ### 图片选择技巧 - **背景简单：** 选择背景干净的图片，就像拍证件照一样 - **光线充足：** 明亮清晰的图片效果更好 - **物体完整：** 确保要转换的物体在图片中完整显示 ### 文字描述技巧 - **用英文：** 系统对英文理解更准确 - **描述详细：** 包含颜色、材质、形状等信息 - **避免复杂：** 简单明确的描述比复杂的更好 ### 多图片合成技巧 - **角度均匀：** 每隔 60-90 度拍一张照片 - **保持一致：** 光线和背景尽量保持一致 - **重叠适度：** 相邻角度的图片要有一定重叠 ### 质量设置建议 - **预览阶段：** 使用 Medium 质量，速度快 - **最终输出：** 使用 High 质量，效果好 - **批量处理：** 可以先用 Low 质量测试 ## 5. 常见问题解答 **Q：为什么我的 API Key 不工作？** A：检查是否从官网正确获取，确保没有多余的空格或字符。 **Q：生成的 3D 模型在哪里？** A：默认保存在 ComfyUI 的 output 文件夹中，文件格式通常是 .obj 或 .glb。 **Q：为什么生成很慢？** A：3D 模型生成需要大量计算，High 质量会更慢，建议先用 Medium 质量测试。 **Q：支持哪些图片格式？** A：支持常见的 JPG、PNG、BMP 等格式，建议使用 PNG 获得最佳效果。 **Q：生成失败怎么办？** A：检查网络连接、API Key 是否正确，图片是否过大（建议小于 10MB）。 ## 6. 进阶应用场景 ### 游戏开发 - 快速制作游戏道具和角色模型 - 从概念图生成 3D 原型 - 批量生成环境装饰物 ### 3D 打印 - 将照片转换为可打印的 3D 模型 - 制作个性化礼品和纪念品 - 快速原型制作 ### 教育展示 - 制作教学用的 3D 模型 - 历史文物数字化重建 - 科学实验模型展示 ### 艺术创作 - 探索新的数字艺术形式 - 结合传统艺术和现代技术 - 制作互动装置艺术 这个插件就像给你的创作工具箱添加了一个 3D 魔法棒，让平面创作瞬间变成立体世界！记住，熟能生巧，多试几次就能掌握各种技巧了。
ComfyUI图像合并插件comfyui-merge使用教程 2025-07-03 22:44 ComfyUI 图像合并插件教程 (comfyui-merge) 1. 插件简介 这是一个专门用来合并图片的 ComfyUI 插件，就像用 PS 把多张图片叠在一起那样。它的特别之处在于你精确控制每张图片的混合方式。 GitHub 地址：https://github.com/LingSss9/com
%20(1).png)
