comfyui-koukoutu
The ComfyUI node integrated with Koukoutu API supports background removal and print cutting functions.
Nodes (12)
Give your cutout a real drop shadow instead of faking it
Background removal, but nothing actually runs on your GPU
Pull the print off a t-shirt without touching Photoshop
The same print extractor, but with the better model underneath
Image-to-image without loading a checkpoint
Turn a square product shot into a banner, no inpaint model required
Find the print on the shirt and crop to it, automatically
A 4x upscale that never touches your VRAM
Your API key
一个为 ComfyUI 提供 Koukoutu API 集成的节点包,涵盖抠图、印花提取、图生图、去水印、AI 阴影、高清放大等多种图像处理功能。
功能一览
| 节点 | 显示名称 | 说明 | |---|---|---| | 抠图 | 抠抠图-抠图功能 | 智能移除图像背景,支持 png/webp 输出 | | 印花定位裁切 | 抠抠图-印花定位裁切功能 | 自动识别并裁切衣服上的印花图案 | | 图生图 | 抠抠图-图生图功能 | 根据提示词生成新的图像 | | 标准印花提取 | 抠抠图-标准印花提取功能 | 从图像中提取指定类型的印花/图案 | | 中阶印花提取 | 抠抠图-中阶印花提取功能 | 效果更优的印花提取模型 | | 高阶印花提取 | 抠抠图-高阶印花提取功能 | 高精度印花提取,支持按比例或自定义宽高输出 | | 去水印 | 抠抠图-去水印功能 | 自动移除图像中的水印 | | AI 生成阴影 | 抠抠图-AI 生成阴影图功能 | 为透明图层图像生成 AI 阴影效果 | | 通用放大 | 抠抠图-通用放大变清晰功能 | 高清放大图像,可选 2x/4x/6x | | 扩图 | 抠抠图-扩图功能 | AI 扩展图像边缘,支持上/下/左/右独立设置 | | 图片转 SVG | 抠抠图-图片转SVG功能(位图转矢量) | 将位图转换为矢量 SVG,并保存到 output 目录 | | SVG 预览 | 抠抠图-SVG预览功能(矢量图预览) | 在节点内直接预览 SVG,无需额外渲染依赖 |
安装
-
将存储库克隆到 ComfyUI 的
custom_nodes目录:cd custom_nodes git clone https://github.com/zhenzi0322/comfyui-koukoutu.git -
安装依赖:
pip install -r requirements.txt -
重启 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 开发者中心 获取支持。











