| 参数名称 | 说明 |
|---|---|
| image | 输入图像张量，支持批量处理。 |
| caption | （可选）一组图像对应的文字标签，强制输入。 |
Add Label
节点功能：主要功能是在输入图像上添加文本标签，可以将标签放置在图像的上方、下方、左侧、右侧或直接覆盖在图像上。（不支持中文）
输入参数
输出参数
| 参数名称 | 说明 |
|---|---|
| IMAGE | 输出添加文字标签后的图像序列。 |
控件参数
| 参数名称 | 说明 |
|---|---|
| text_x | 文本在图像中的水平起始位置（单位：像素）。 |
| text_y | 文本在图像中的垂直起始位置（单位：像素）。 |
| height | 标签区域高度（像素），若为 -1，则自动适应文本高度。 |
| font_size | 字体大小（单位：像素）。 |
| font_color | 文本颜色，使用 HTML/CSS 标准颜色名或 HEX 值。 |
| label_color | 标签区域背景色，使用标准颜色名或 HEX 值。 |
| font | 字体文件名，需存在于 custom_nodes/ComfyUI-KJNodes/fonts 目录中。 |
| text | 要显示的文字内容，支持多行文本。 |
| direction | 文字附加方向，枚举值包括：up、down、left、right、overlay。 |
- text_x: 文本在标签图像中的X坐标位置
- text_y: 文本在标签图像中的Y坐标位置
- height: 标签图像的高度（设为-1时会自动调整高度）
- font_size: 字体大小
- font_color: 字体颜色
label_color: 标签背景颜色（默认值："black"）
direction: 标签放置方向，ovlerlay模式标签背景和原图重合了。
caption为每张图像单独指定不同的文本标签。它支持批处理场景，即输入的是一个图像 batch（例如多个图像），caption 则可以提供与之对应数量的文字描述，每张图都会用相应的 caption。需要注意，如果输入的是两张图片，则只能在caption中输入2个字符，比如这里输入的是“12”，否则会报错，还有caption的优先级要大于Add Label节点中的text，比如下面text中输入了“xiaoming”,但是它并没有在图片上输出。