%20(1).png)
ComfyUI-BRIA-API 插件完全使用指南
1. 插件简介
ComfyUI-BRIA-API 是一个专门为 ComfyUI 设计的插件，它就像一座桥梁，把 BRIA 公司的人工智能图像处理服务连接到你的 ComfyUI 工作流中。
GitHub 原地址： https://github.com/Bria-AI/ComfyUI-BRIA-API
这个插件能给你带来什么？
- 把文字变成图片（就像对着画家说"画一只猫"，然后自动生成图片）
- 给图片换背景（像换衣服一样简单）
- 抠图去背景（一键把人物从背景中"抠"出来）
- 修复图片（把图片中不想要的东西"擦掉"）
- 扩展图片（让图片变得更大，自动填充空白部分）
重要提醒： 使用这个插件需要 BRIA 的钥匙（我们叫它令牌），就像进入会员俱乐部需要会员卡一样。
2. 如何安装
方法一：通过管理器安装（推荐新手）
- 打开你的 ComfyUI
- 找到"自定义节点管理器"（Custom Node Manager）
- 点击"安装缺失节点"或者搜索"BRIA"
- 找到后点击安装就行了
方法二：手动安装（适合有经验的用户）
- 找到你的 ComfyUI 安装文件夹
- 进入
custom_nodes文件夹 - 在这里下载插件文件
- 重启 ComfyUI
3. 节点详细解析
3.1 文字生成图片类节点
3.1.1 Text2Image Base（基础文字生图）
这个节点就像一个基础画家，你给它一段文字描述，它就能画出对应的图片。
参数详解：
| 参数名 (界面显示) | 参数名 (代码中) | 参数类型 | 建议值 | 通俗解释 | 专业解释 | 使用举例 |
|---|---|---|---|---|---|---|
| 提示词 | prompt | 文本输入 | 详细描述 | 告诉人工智能你想要什么图片，就像给画家下指令 | 用自然语言描述期望生成的图像内容 | "一只可爱的橘色小猫在花园里玩耍" |
| 图像尺寸 | dimensions | 选择项 | 1024x1024 | 决定生成图片的大小，就像选择画布大小 | 控制输出图像的分辨率和宽高比 | 方形图片选1024x1024，长图选16:9 |
| 风格 | style | 选择项 | 根据需要 | 决定图片的绘画风格，就像选择用油画还是水彩画 | 应用不同的艺术风格和渲染方式 | 照片风格、卡通风格、艺术风格等 |
3.1.2 Text2Image Fast（快速文字生图）
这个节点就像一个快手画家，虽然画得快，但质量依然不错。
参数详解：
| 参数名 (界面显示) | 参数名 (代码中) | 参数类型 | 建议值 | 通俗解释 | 专业解释 | 使用举例 |
|---|---|---|---|---|---|---|
| 提示词 | prompt | 文本输入 | 简洁明了 | 告诉人工智能你想要什么图片，快速模式下建议简单描述 | 用于快速生成的文本描述 | "红色跑车" |
| 图像尺寸 | dimensions | 选择项 | 512x512 | 决定图片大小，快速模式建议用小一点的尺寸 | 为快速生成优化的图像尺寸 | 常用512x512或768x768 |
| 种子值 | seed | 数字 | 随机 | 就像抽奖的号码，同样的号码会得到相同的结果 | 控制随机性，确保结果可重现 | 固定数字如12345，或-1表示随机 |
3.1.3 Text2Image HD（高清文字生图）
这个节点就像一个精细画家，专门画高清大图，细节丰富。
参数详解：
| 参数名 (界面显示) | 参数名 (代码中) | 参数类型 | 建议值 | 通俗解释 | 专业解释 | 使用举例 |
|---|---|---|---|---|---|---|
| 提示词 | prompt | 文本输入 | 极其详细 | 告诉人工智能你想要什么图片，高清模式需要详细描述 | 用于高分辨率生成的详细文本描述 | "一位穿着蓝色连衣裙的女孩在夕阳下的麦田里奔跑，头发飘逸，表情愉悦" |
| 图像尺寸 | dimensions | 选择项 | 1024x1024以上 | 决定图片大小，高清模式建议用大尺寸 | 支持高分辨率输出的图像尺寸 | 1024x1024, 1536x1536等 |
| 质量等级 | quality | 选择项 | 高 | 决定图片的清晰度和细节程度 | 控制图像渲染质量和处理时间 | 高质量模式用于最终输出 |
| 细节增强 | enhance_details | 是/否 | 是 | 是否要让图片的细节更加清晰 | 是否启用细节增强算法 | 人像照片建议开启 |
3.1.4 Reimagine（重新想象）
这个节点就像一个创意画家，它会看着你给的图片，然后用新的方式重新画一遍。
参数详解：
| 参数名 (界面显示) | 参数名 (代码中) | 参数类型 | 建议值 | 通俗解释 | 专业解释 | 使用举例 |
|---|---|---|---|---|---|---|
| 输入图片 | input_image | 图片 | 必需 | 你要重新创作的原始图片 | 作为参考的输入图像 | 上传一张风景照 |
| 提示词 | prompt | 文本输入 | 创意描述 | 告诉人工智能你想要什么样的新效果 | 指导重新创作的文本描述 | "把这张图片变成油画风格" |
| 创作强度 | creativity_strength | 滑块 | 0.5-0.8 | 控制改变程度，就像调节创作的"胆量" | 控制与原图的相似度 | 0.3保守，0.8大胆 |
| 保持结构 | preserve_structure | 是/否 | 是 | 是否保持原图的基本布局 | 是否保持原图的构图和结构 | 人像照片建议保持 |
3.2 定制化生成类节点
3.2.1 Tailored Gen（定制生成）
这个节点就像一个专业画家，它学会了特定的绘画风格或者品牌要求。
参数详解：
| 参数名 (界面显示) | 参数名 (代码中) | 参数类型 | 建议值 | 通俗解释 | 专业解释 | 使用举例 |
|---|---|---|---|---|---|---|
| 模型名称 | model_name | 文本输入 | 从列表选择 | 你要使用的专业画家名字 | 指定要使用的定制模型 | "company_logo_style" |
| 提示词 | prompt | 文本输入 | 符合模型风格 | 告诉专业画家你想要什么 | 与定制模型匹配的文本描述 | "设计一个现代简约的标志" |
| 风格权重 | style_weight | 滑块 | 0.8 | 控制专业风格的强度 | 控制定制风格的影响程度 | 0.5轻微风格，1.0完全风格 |
| 创作自由度 | creativity | 滑块 | 0.6 | 允许画家发挥创意的程度 | 控制生成结果的变化程度 | 0.3保守，0.8创新 |
3.2.2 Tailored Model Info（定制模型信息）
这个节点就像一个助手，它会告诉你某个专业画家的特长和工作方式。
参数详解：
| 参数名 (界面显示) | 参数名 (代码中) | 参数类型 | 建议值 | 通俗解释 | 专业解释 | 使用举例 |
|---|---|---|---|---|---|---|
| 模型名称 | model_name | 文本输入 | 必需 | 你要了解的专业画家名字 | 要查询信息的定制模型名称 | "brand_style_v2" |
| 输出信息 | output_info | 输出 | 自动 | 系统会自动显示这个画家的信息 | 返回模型的配置信息和使用说明 | 显示推荐设置和提示词前缀 |
3.2.3 Restyle Portrait（人像风格转换）
这个节点专门给人像照片换风格，就像给人换装或者换发型。
参数详解：
| 参数名 (界面显示) | 参数名 (代码中) | 参数类型 | 建议值 | 通俗解释 | 专业解释 | 使用举例 |
|---|---|---|---|---|---|---|
| 输入人像 | input_portrait | 图片 | 必需 | 你要改变风格的人像照片 | 输入的人像图像 | 上传一张清晰的人像照 |
| 目标风格 | target_style | 选择项 | 根据需要 | 你想要的新风格 | 要应用的艺术风格 | 油画风格、卡通风格、素描风格 |
| 保持相似度 | preserve_identity | 滑块 | 0.8 | 保持人物长相的程度 | 控制人物特征保持程度 | 0.9高相似度，0.5低相似度 |
| 风格强度 | style_intensity | 滑块 | 0.7 | 新风格的强烈程度 | 控制风格转换的强度 | 0.5轻微，1.0完全转换 |
3.3 图片编辑类节点
3.3.1 RMBG 2.0 (Remove Background)（去背景）
这个节点就像一把精准的剪刀，能把人物从背景中完美"剪"出来。
参数详解：
| 参数名 (界面显示) | 参数名 (代码中) | 参数类型 | 建议值 | 通俗解释 | 专业解释 | 使用举例 |
|---|---|---|---|---|---|---|
| 输入图片 | input_image | 图片 | 必需 | 你要去掉背景的图片 | 需要移除背景的原始图像 | 上传一张人物照片 |
| 精度等级 | precision_level | 选择项 | 高 | 抠图的精细程度 | 背景移除的精确度等级 | 人像用高精度，物体用标准 |
| 边缘处理 | edge_smoothing | 是/否 | 是 | 是否让剪切边缘更平滑 | 是否对抠图边缘进行平滑处理 | 一般建议开启 |
| 输出格式 | output_format | 选择项 | PNG | 保存图片的格式 | 输出图像的文件格式 | PNG支持透明背景 |
3.3.2 Replace Background（替换背景）
这个节点就像一个背景替换师，能给图片换上新背景。
参数详解：
| 参数名 (界面显示) | 参数名 (代码中) | 参数类型 | 建议值 | 通俗解释 | 专业解释 | 使用举例 |
|---|---|---|---|---|---|---|
| 主体图片 | subject_image | 图片 | 必需 | 你要保留的主体图片 | 包含要保留主体的图像 | 人物照片 |
| 新背景图片 | background_image | 图片 | 可选 | 你想要的新背景图片 | 用作新背景的参考图像 | 风景照片 |
| 背景描述 | background_prompt | 文本输入 | 可选 | 用文字描述你想要的背景 | 描述期望背景的文本 | "夕阳下的海滩" |
| 融合程度 | blend_strength | 滑块 | 0.8 | 主体和背景的融合程度 | 控制主体与背景的融合强度 | 0.7自然融合，0.9强融合 |
| 光照匹配 | lighting_match | 是/否 | 是 | 是否让主体的光照和背景匹配 | 是否调整主体光照以匹配背景 | 建议开启更自然 |
3.3.3 Expand Image（扩展图片）
这个节点就像一个魔法师，能让图片变大，并自动填充空白部分。
参数详解：
| 参数名 (界面显示) | 参数名 (代码中) | 参数类型 | 建议值 | 通俗解释 | 专业解释 | 使用举例 |
|---|---|---|---|---|---|---|
| 输入图片 | input_image | 图片 | 必需 | 你要扩展的原始图片 | 需要扩展的源图像 | 上传你的图片 |
| 扩展方向 | expand_direction | 选择项 | 全方向 | 朝哪个方向扩展图片 | 指定图像扩展的方向 | 向上、向下、向左、向右、全方向 |
| 扩展尺寸 | expand_size | 数字 | 256 | 每个方向扩展多少像素 | 扩展区域的像素数量 | 128小幅扩展，512大幅扩展 |
| 填充提示 | fill_prompt | 文本输入 | 描述环境 | 告诉系统如何填充新空间 | 指导扩展区域内容生成的文本 | "继续森林场景" |
| 保持一致性 | maintain_consistency | 是/否 | 是 | 是否保持扩展部分和原图的一致性 | 是否确保扩展内容与原图风格一致 | 建议开启 |
3.3.4 Eraser（橡皮擦）
这个节点就像一个精确的橡皮擦，能把图片中不想要的东西"擦掉"。
参数详解：
| 参数名 (界面显示) | 参数名 (代码中) | 参数类型 | 建议值 | 通俗解释 | 专业解释 | 使用举例 |
|---|---|---|---|---|---|---|
| 输入图片 | input_image | 图片 | 必需 | 你要修改的图片 | 需要编辑的原始图像 | 有不想要物体的照片 |
| 擦除区域 | mask_image | 图片 | 必需 | 标记要擦掉的区域的图片 | 指定要移除区域的蒙版图像 | 白色表示要擦除的区域 |
| 填充方式 | fill_mode | 选择项 | 智能填充 | 选择如何填充被擦掉的空间 | 选择空白区域的填充方法 | 智能填充、纯色填充 |
| 边缘羽化 | edge_feather | 滑块 | 3 | 让擦除边缘更自然 | 控制擦除边缘的平滑程度 | 1-5之间，3比较自然 |
3.3.5 GenFill（生成填充）
这个节点就像一个创意画家，能在图片的指定区域画出你想要的东西。
参数详解：
| 参数名 (界面显示) | 参数名 (代码中) | 参数类型 | 建议值 | 通俗解释 | 专业解释 | 使用举例 |
|---|---|---|---|---|---|---|
| 输入图片 | input_image | 图片 | 必需 | 你要添加内容的图片 | 需要添加内容的基础图像 | 空旷的房间照片 |
| 填充区域 | fill_area | 图片 | 必需 | 标记要填充内容的区域 | 指定要生成内容的区域蒙版 | 白色区域表示要填充的地方 |
| 填充描述 | fill_prompt | 文本输入 | 详细描述 | 告诉系统你想在这个区域画什么 | 描述要生成内容的文本 | "一张红色的沙发" |
| 融合强度 | blend_strength | 滑块 | 0.8 | 新内容和原图的融合程度 | 控制生成内容与原图的融合强度 | 0.7自然，0.9强融合 |
| 风格匹配 | style_match | 是/否 | 是 | 是否让新内容的风格和原图匹配 | 是否确保生成内容与原图风格一致 | 建议开启 |
3.3.6 Erase Foreground（擦除前景）
这个节点和去背景相反，它会把前景主体"擦掉"，只留下背景。
参数详解：
| 参数名 (界面显示) | 参数名 (代码中) | 参数类型 | 建议值 | 通俗解释 | 专业解释 | 使用举例 |
|---|---|---|---|---|---|---|
| 输入图片 | input_image | 图片 | 必需 | 你要处理的图片 | 需要移除前景的图像 | 有人物的风景照 |
| 检测精度 | detection_precision | 选择项 | 高 | 识别前景的精确程度 | 前景检测的准确度级别 | 复杂场景用高精度 |
| 填充方式 | fill_method | 选择项 | 智能修复 | 选择如何填充前景被移除的空间 | 选择空白区域的修复方法 | 智能修复、模糊填充 |
| 边缘处理 | edge_processing | 是/否 | 是 | 是否对移除边缘进行处理 | 是否对移除区域边缘进行平滑处理 | 建议开启 |
3.4 电商产品类节点
3.4.1 ShotByText（文字背景替换）
这个节点专门为产品照片设计，能根据文字描述给产品换背景。
参数详解：
| 参数名 (界面显示) | 参数名 (代码中) | 参数类型 | 建议值 | 通俗解释 | 专业解释 | 使用举例 |
|---|---|---|---|---|---|---|
| 产品图片 | product_image | 图片 | 必需 | 你的产品照片 | 需要更换背景的产品图像 | 白底产品照 |
| 背景描述 | background_description | 文本输入 | 详细描述 | 用文字描述你想要的背景场景 | 描述期望背景场景的文本 | "现代简约的客厅环境" |
| 产品尺寸 | product_scale | 滑块 | 1.0 | 产品在新背景中的大小比例 | 控制产品在场景中的相对大小 | 0.8较小，1.2较大 |
| 光照风格 | lighting_style | 选择项 | 自然光 | 选择背景的光照风格 | 选择场景的光照类型 | 自然光、室内光、戏剧光 |
| 场景深度 | scene_depth | 滑块 | 0.7 | 控制背景的空间深度感 | 控制背景场景的景深效果 | 0.5浅景深，0.9深景深 |
3.4.2 ShotByImage（图片背景替换）
这个节点也是为产品照片设计，但它用另一张图片作为背景参考。
参数详解：
| 参数名 (界面显示) | 参数名 (代码中) | 参数类型 | 建议值 | 通俗解释 | 专业解释 | 使用举例 |
|---|---|---|---|---|---|---|
| 产品图片 | product_image | 图片 | 必需 | 你的产品照片 | 需要更换背景的产品图像 | 白底手机照片 |
| 背景参考图 | background_reference | 图片 | 必需 | 你想要模仿的背景图片 | 作为背景风格参考的图像 | 咖啡厅环境照片 |
| 产品位置 | product_position | 选择项 | 中心 | 产品在新背景中的位置 | 指定产品在场景中的摆放位置 | 左侧、中心、右侧 |
| 风格匹配度 | style_matching | 滑块 | 0.8 | 新背景模仿参考图的程度 | 控制生成背景与参考图的相似度 | 0.5松散模仿，1.0严格模仿 |
| 产品融合 | product_integration | 滑块 | 0.7 | 产品与背景的融合程度 | 控制产品与背景的自然融合度 | 0.9高融合度 |
4. 使用技巧和建议
4.1 新手入门建议
- 先从简单的开始：建议新手先试试 Text2Image Base 和 RMBG 2.0，这两个最容易上手
- 提示词要详细：就像和画家聊天一样，说得越详细，效果越好
- 多试试不同参数：每个滑块都试试不同的值，看看效果如何变化
4.2 提示词写作技巧
- 描述要具体：不要只说"一只猫"，要说"一只橘色的长毛猫，坐在红色沙发上"
- 加上风格词：比如"摄影风格"、"卡通风格"、"油画风格"
- 注意顺序：重要的内容写在前面，不重要的写在后面
4.3 参数调节建议
- 种子值的使用：如果你喜欢某个结果，记住种子值，下次可以复用
- 滑块参数：建议从中间值开始调，然后往两边试
- 质量和速度的平衡：急用的话选 Fast 模式，精品输出选 HD 模式
4.4 工作流搭建建议
- 模块化思维：把复杂任务分解成几个简单步骤
- 保存模板：好用的工作流要保存起来，方便复用
- 测试小图：调试时用小图，确定效果后再用大图
5. 常见问题解答
5.1 关于令牌（钥匙）
问：我没有 BRIA 的令牌怎么办？
答：你需要去 BRIA 官网（https://bria.ai/api/）注册账号并申请令牌。就像办会员卡一样，注册后就能获得。
问：令牌用完了怎么办？
答：令牌就像话费一样，用完了需要充值。你可以在 BRIA 官网充值。
5.2 关于图片质量
问：为什么生成的图片质量不好？
答：可能的原因有：
- 提示词太简单，试试写得更详细
- 图片尺寸选择不当，试试更大的尺寸
- 质量参数设置太低，试试调高一点
问：为什么抠图效果不好？
答：可能的原因有：
- 原图背景太复杂，试试背景简单的图片
- 精度等级设置太低，试试调成高精度
- 图片分辨率太低，试试用高分辨率图片