Extensions/comfyui-koukoutu
ComfyUI Extension

comfyui-koukoutu

The ComfyUI node integrated with Koukoutu API supports background removal and print cutting functions.

By zhenzi0322·Created about a year ago·Updated 18 days ago· 4
zhenzi0322/comfyui-koukoutu
Nodes12
On cloudLocal install
Categoryimage/koukoutu
Stars4
Updated18 days ago
Readme
<div align="center"> <img src="https://res.cloudinary.com/anuraghazra/image/upload/v1594908242/logo_ccswme.svg" width="100px" alt="GitHub Readme Stats" /> <h1 style="font-size: 28px; margin: 10px 0;">ComfyUI-koukoutu</h1> </div>

一个为 ComfyUI 提供 Koukoutu API 集成的节点包,涵盖抠图、印花提取、图生图、去水印、AI 阴影、高清放大等多种图像处理功能。

功能一览

| 节点 | 显示名称 | 说明 | |---|---|---| | 抠图 | 抠抠图-抠图功能 | 智能移除图像背景,支持 png/webp 输出 | | 印花定位裁切 | 抠抠图-印花定位裁切功能 | 自动识别并裁切衣服上的印花图案 | | 图生图 | 抠抠图-图生图功能 | 根据提示词生成新的图像 | | 标准印花提取 | 抠抠图-标准印花提取功能 | 从图像中提取指定类型的印花/图案 | | 中阶印花提取 | 抠抠图-中阶印花提取功能 | 效果更优的印花提取模型 | | 高阶印花提取 | 抠抠图-高阶印花提取功能 | 高精度印花提取,支持按比例或自定义宽高输出 | | 去水印 | 抠抠图-去水印功能 | 自动移除图像中的水印 | | AI 生成阴影 | 抠抠图-AI 生成阴影图功能 | 为透明图层图像生成 AI 阴影效果 | | 通用放大 | 抠抠图-通用放大变清晰功能 | 高清放大图像,可选 2x/4x/6x | | 扩图 | 抠抠图-扩图功能 | AI 扩展图像边缘,支持上/下/左/右独立设置 | | 图片转 SVG | 抠抠图-图片转SVG功能(位图转矢量) | 将位图转换为矢量 SVG,并保存到 output 目录 | | SVG 预览 | 抠抠图-SVG预览功能(矢量图预览) | 在节点内直接预览 SVG,无需额外渲染依赖 |

安装

  1. 将存储库克隆到 ComfyUI 的 custom_nodes 目录:

    cd custom_nodes
    git clone https://github.com/zhenzi0322/comfyui-koukoutu.git
    
  2. 安装依赖:

    pip install -r requirements.txt
    
  3. 重启 ComfyUI,在 image/koukoutu 分类下即可看到所有节点。

也可以直接通过comfy node install koukoutu进行安装。

获取 API Key

访问 Koukoutu 开发者中心 注册账户并获取 API Key。


节点详细说明

1. 抠图功能(Background Removal)

使用抠抠图同步 API 智能移除图像背景。

| 输入 | 类型 | 必填 | 说明 | |---|---|---|---| | image | IMAGE | 是 | 输入图像 | | api_key | STRING | 是 | API Key | | output_format | List | 否 | 输出格式:png(默认)/ webp | | auto_crop | BOOLEAN | 否 | 是否自动识别裁切印花区域 |

输出: IMAGE

启用"印花自动识别裁切"可自动剪切出衣服上的印花图案并进行抠图。

禁用裁切则直接输出抠图结果。


2. 印花定位裁切功能(Stamp Crop)

使用异步 API 自动定位并裁切图像中的印花/图案区域。

| 输入 | 类型 | 必填 | 说明 | |---|---|---|---| | image | IMAGE | 是 | 输入图像 | | api_key | STRING | 是 | API Key | | skip_error | BOOLEAN | 否 | 跳过错误(默认开) |

输出: IMAGE + STRING(成功/错误信息)

工作流


3. 图生图功能(Image To Image)

根据提示词,基于输入图像生成新的图像。

| 输入 | 类型 | 必填 | 说明 | |---|---|---|---| | image | IMAGE | 是 | 输入图像 | | api_key | STRING | 是 | API Key | | prompt | STRING | 是 | 生成提示词 | | negative_prompt | STRING | 否 | 反向提示词 | | similarity | FLOAT | 否 | 相似度 0~1,默认 0.80 | | type | List | 否 | 类型:1 / 2 | | skip_error | BOOLEAN | 否 | 跳过错误(默认开) |

输出: IMAGE + STRING(成功/错误信息)

工作流


4. 标准印花提取功能(Image Extract)

从图像中提取指定类型的印花或图案。

| 输入 | 类型 | 必填 | 说明 | |---|---|---|---| | image | IMAGE | 是 | 输入图像 | | api_key | STRING | 是 | API Key | | extract_type | STRING | 是 | 提取类型,如 服装、鞋包、配饰 | | resolution | List | 否 | 分辨率:1k / 4k | | size | List | 否 | 输出比例,19 种可选,默认 0:0(原图尺寸) | | skip_error | BOOLEAN | 否 | 跳过错误(默认开) |

输出: IMAGE + STRING(成功/错误信息)

工作流


5. 中阶印花提取功能(Image Extract V2)

效果更优的印花提取模型,参数与标准版相同。

| 输入 | 类型 | 必填 | 说明 | |---|---|---|---| | image | IMAGE | 是 | 输入图像 | | api_key | STRING | 是 | API Key | | extract_type | STRING | 是 | 提取类型,如 服装、鞋包、配饰 | | resolution | List | 否 | 分辨率:1k / 4k | | size | List | 否 | 输出比例,19 种可选,默认 0:0(原图尺寸) | | skip_error | BOOLEAN | 否 | 跳过错误(默认开) |

输出: IMAGE + STRING(成功/错误信息)

工作流


6. 去水印功能(Watermark Removal)

自动移除图像中的水印。

| 输入 | 类型 | 必填 | 说明 | |---|---|---|---| | image | IMAGE | 是 | 输入图像 | | api_key | STRING | 是 | API Key | | skip_error | BOOLEAN | 否 | 跳过错误(默认开) |

输出: IMAGE + STRING(成功/错误信息)

工作流


7. AI 生成阴影图功能(AI Shadow)

为带透明图层的 PNG 图像(抠图后)生成 AI 阴影效果。

| 输入 | 类型 | 必填 | 说明 | |---|---|---|---| | image | IMAGE | 是 | 必须为透明 PNG(抠图后的图片) | | api_key | STRING | 是 | API Key | | shadow_opacity | FLOAT | 否 | 阴影浓度 0~1,默认 0.75 | | main_ratio | FLOAT | 否 | 主体占比 0~100,默认 80 | | background_color | STRING | 否 | 背景颜色,如 #ffffff,留空输出透明图 | | skip_error | BOOLEAN | 否 | 跳过错误(默认开) |

输出: IMAGE + STRING(成功/错误信息)

工作流


8. 通用放大变清晰功能(Upscale)

对图像进行高清放大,提升清晰度。

| 输入 | 类型 | 必填 | 说明 | |---|---|---|---| | image | IMAGE | 是 | 输入图像 | | api_key | STRING | 是 | API Key | | scale | List | 否 | 放大倍数:2 / 4(默认) / 6 | | skip_error | BOOLEAN | 否 | 跳过错误(默认开) |

输出: IMAGE + STRING(成功/错误信息)

示例效果图

下载工作流

9. 扩图功能(Outpaint)

使用 AI 智能扩展图像边缘,支持分别设置上、下、左、右四个方向的扩图边距。

| 输入 | 类型 | 必填 | 说明 | |---|---|---|---| | image | IMAGE | 是 | 输入图像 | | api_key | STRING | 是 | API Key | | left | INT | 否 | 左侧扩图边距(像素),默认 0 | | right | INT | 否 | 右侧扩图边距(像素),默认 0 | | top | INT | 否 | 上方扩图边距(像素),默认 365 | | bottom | INT | 否 | 下方扩图边距(像素),默认 0 | | skip_error | BOOLEAN | 否 | 跳过错误(默认开) |

输出: IMAGE + STRING(成功/错误信息)


10. 图片转 SVG(Image To SVG)

使用异步 API(image-to-svg)将位图转换为矢量 SVG 文件。

| 输入 | 类型 | 必填 | 说明 | |---|---|---|---| | image | IMAGE | 是 | 输入图像 | | api_key | STRING | 是 | API Key | | skip_error | BOOLEAN | 否 | 跳过错误(默认开) |

输出: svg(SVG 源码文本)+ message(成功/错误信息)

示例效果图

下载工作流

处理结果同时会写入 ComfyUI 的 output 目录(文件名形如 koukoutu_svg_<时间>_<task_id>.svg),保存路径包含在 message 中。


11. 高阶印花提取(Image Extract V3)

使用异步 API(koukoutu-extract-v3.5)进行高精度印花/图案提取。

| 输入 | 类型 | 必填 | 说明 | |---|---|---|---| | image | IMAGE | 是 | 输入图像 | | api_key | STRING | 是 | API Key | | size_mode | List | 否 | 尺寸方式:按比例(默认) / 按宽高,两种方式互斥 | | size | List | 否 | 输出比例,默认 0:0(按原图尺寸),仅按比例模式生效 | | resolution | List | 否 | 输出分辨率:2k(默认) / 4k,仅按比例模式生效 | | w | INT | 否 | 输出宽度,默认 1024,仅按宽高模式生效 | | h | INT | 否 | 输出高度,默认 1024,仅按宽高模式生效 | | skip_error | BOOLEAN | 否 | 跳过错误(默认开) |

输出: IMAGE + STRING(成功/错误信息)

size + resolution 与 w + h 互斥,节点会仅提交当前模式对应的一组参数;切换 size_mode 时面板会自动显示/隐藏对应参数;宽高模式下 w × h 不能超过 4096 × 4096,超出会被节点直接拦截。

示例效果图

示例效果图

下载工作流


工作流

下载示例工作流

错误处理

所有异步节点均支持 skip_error 参数:

  • 开启(默认):遇到 API 错误时返回原图 + 错误信息文本,不中断工作流。
  • 关闭:遇到错误时抛出异常,中断工作流。

可通过连接 STRING 输出到文本节点或显示节点来查看错误详情。

高阶印花提取节点额外把 API Key 为空/无效、参数越界、网络异常、任务超时等错误也统一写入 message,默认不会因这些错误中断工作流(skip_error 关闭时才会抛异常)。

相关功能查找

SVG 预览(SVG Preview)

在节点面板内直接渲染 SVG 矢量图,不依赖任何额外的光栅化库,也不会上传图片。

| 输入 | 类型 | 必填 | 说明 | |---|---|---|---| | svg | STRING | 是 | SVG 源码,可直接粘贴,也可接 图片转 SVG 节点的 svg 输出 |

输出: 无(纯预览节点,执行后只在节点内渲染)


支持

如有问题或建议,请访问 Koukoutu 开发者中心 获取支持。