| 输入参数 | |
| image | 输入图像，可包含透明通道。 |
| 输出参数 | |
| cropped_image | 最终输出的裁剪图像，按设定比例居中裁切并可 letterbox 填充。 |
| box_preview | 可视化裁剪框预览图，展示裁剪边界和检测到的前景区域。 |
| cropped_mask | 与裁剪图对应的前景掩膜，格式为 1 通道的二值图。 |
| 控件参数 | |
| background_color | 裁剪后的背景填充色，格式为 #RRGGBB。 |
| aspect_ratio | 输出图像的宽高比选项，包括常见比例、自定义或自动检测。 |
| proportional_width | 自定义宽高比时的宽度比例值。 |
| proportional_height | 自定义宽高比时的高度比例值。 |
| scale_to_longest_side | 是否强制缩放输出图像最长边到设定值。 |
| longest_side | 设定的最大长边像素，默认 1024。 |
| detect | 前景检测方法，可选：min_bounding_rect, max_inscribed_rect, mask_area。 min_bounding_rect：生成贴合前景物体的最小包围矩形裁剪框。 max_inscribed_rect：找出前景物体内最大矩形裁剪框。 mask_area：按前景蒙版面积等确定裁剪框。 |
| border_reserve | 在裁剪框周围保留的边缘像素。 |
| ultra_detail_range | 掩膜精细化像素半径，影响边缘细节。 |
| matting_method | 前景掩膜生成方式，支持 RMBG 1.4 和 SegmentAnything。 |
| sam_model | 用于 SegmentAnything 的模型名。 |
| grounding_dino_model | 用于 GroundingDINO 提示词识别的模型名。 |
| sam_threshold | GroundingDINO 提示框置信度阈值，范围 0~1。 |
| sam_prompt | GroundingDINO 的检测提示词，如 subject。 |
关于图像比例控制以及缩放策略，大家可前往LayerUtility: ImageScaleByAspectRatio节点查看用法，这里介绍的很详细。
指定background_color背景颜色填充
border_reserve: 裁剪边界扩展，负值收缩，正值扩展
ultra_detail_range: 遮罩边缘精细调整，相当于蒙版模糊羽化的效果
matting_method: 背景去除方法
SegmentAnything去除背景更干净，但也会少一些细节，比如人物最顶上的头发也被去除了。
sam_threshold: 检测阈值，值越大，检测越干净，但容易丢失细节。值过小则导致背景移除不干净。
sam_prompt: 检测目标提示词，这里换为了cloud，则检测云朵。
可加入知识星球获取所有示例工作流
微信扫码入群，加入AIGC大家庭，与大家一起交流学习