ByteDanceSeedreamLayerSeparationNode - ComfyUI Built-in Node Documentation

ByteDance Seedream 5.0 Pro 图层分离功能可将图像分解为一个背景底板以及最多 16 个可重新定位的透明图层，每个图层均具有堆叠顺序、边界框、名称和描述。它返回背景、带掩码的各图层图像、放置框以及可直接编辑的图层堆栈。

输入

参数	描述	数据类型	必需	范围
`image`	要分离的图像。必须恰好一张图像，至少 512x512 像素，宽高比在 1:16 到 16:1 之间。大于约 4MP 的输入在上传前会缩小。	IMAGE	是	Single image
`prompt`	如何分离图像。留空则自动检测并分离所有主要元素。用自然语言描述元素以控制分离，或使用 `<bbox>left top right bottom</bbox>` 标签（0-1000 千分比坐标）指定精确区域。默认值：空字符串。	STRING	是	Multiline text
`size`	输出分辨率级别。“auto” 跟随输入图像尺寸（限制在 1K-2K 范围内）。默认值：“auto”。	COMBO	是	”auto" "1K" "1.5K" "2K”
`seed`	用于生成的种子。默认值：0。	INT	是	0 到 2147483647
`prompt_optimization`	提示优化模式：“standard” 提供更高质量，“fast” 缩短生成时间。默认值：“standard”。	COMBO	否	”standard" "fast”
`watermark`	是否在图像上添加 “AI generated” 水印。默认值：false。	BOOLEAN	否	false true
`crop_layers`	图层/掩码批次输出的几何形状（layer_stack 不受影响，始终紧凑）。完整画布：每个图层位于基础尺寸画布上其边界框位置 - 可直接使用 ImageCompositeMasked 重新合成。最小尺寸：每个图层裁剪到其边界框（为批处理填充到最大图层） - 张量小得多；使用 bboxes 输出通过 Layers From Bounding Boxes 重建放置。默认值：false（完整画布）。	BOOLEAN	否	false (full canvas) true (minimal size)

注意：输入 image 必须是单张图像；不支持批次。图像必须至少为 512x512 像素，宽高比在 1:16 到 16:1 之间。

输出名称	描述	数据类型
`base_image`	图层堆叠的基础图像（背景底板）。	IMAGE
`base_mask`	基础图像的透明度（1 = 透明，LoadImage 约定）；目前始终完全不透明。	MASK
`layers`	从底到顶排序的透明图层。完整画布模式：放置在黑色基础尺寸画布上其边界框位置。最小尺寸模式：裁剪到其边界框，锚定左上角，填充到最大图层。	IMAGE
`masks`	每层透明度，与 layers 批次索引对齐（1 = 透明，LoadImage 约定）。对于 ImageCompositeMasked 风格的合成，先添加 InvertMask。	MASK
`bboxes`	每个图层一个放置框，与 layers 批次索引对齐（将两者以及 masks 一起输入 Layers From Bounding Boxes 以重建每层放置）：`{x, y, width, height, metadata: {name, desc, z_index, native_size, content_rect, flags}}`。`content_rect = [left, top, width, height]` 是图层在其自身帧内的内容区域；它落在画布上的位置为框位置加上该偏移。	BOUNDING_BOX
`layer_stack`	用于 Create Layered Image 的可直接编辑图层文档：基础底板加上每个元素作为其自己的命名、紧密裁剪的图层，位于其真实位置和堆叠顺序。可直接连接，或用 Add Layer 扩展。	LAYERS

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！在 GitHub 上编辑

Source fingerprint (SHA-256): 5062760f2930333f8ed7d8b09dff2492c23fdf906ef71b111348687bef572821