1. 引言aigc-comfyui-tools 是一个面向 ComfyUI 工作流自动化的 Python 工具包旨在帮助开发者通过 Python 脚本批量调用 ComfyUI 的 API 接口实现文生图、图生图、模型加载、工作流参数调整、结果回传等常见 AIGC 任务。它把 ComfyUI 的 HTTP API 封装成简洁的 Python 接口让开发者无需手动拼接请求即可在本地脚本、服务端任务或自动化流水线中稳定调用 ComfyUI 能力。本文将从功能特性、安装方式、核心语法与参数、9 个实际应用案例以及常见错误与使用注意事项五个方面系统介绍 aigc-comfyui-tools 的使用方法。2. 功能概述aigc-comfyui-tools 的核心功能可以概括为以下几类工作流提交与执行将 ComfyUI 工作流 JSON 提交到服务端并跟踪执行状态。参数动态注入在提交前修改工作流中的提示词、模型名称、采样步数、尺寸等参数。结果获取与保存从执行结果中提取生成图片并保存到本地或返回 Base64 数据。批量任务调度支持循环提交多个任务适合批量生成、批量测试场景。队列管理查询当前队列状态、清空队列、中断任务等。节点输出读取按节点 ID 读取中间结果便于调试和分析。3. 安装方法aigc-comfyui-tools 通过 pip 安装推荐使用虚拟环境隔离依赖。安装命令如下pip install aigc-comfyui-tools如果需要升级到最新版本可以使用pip install --upgrade aigc-comfyui-tools安装完成后可以通过以下方式验证是否安装成功import comfyui_tools print(comfyui_tools.__version__)如果希望从源码安装可以克隆仓库后执行git clone https://github.com/your-repo/aigc-comfyui-tools.git cd aigc-comfyui-tools pip install -e .4. 核心语法与参数使用 aigc-comfyui-tools 的基本流程是创建客户端、加载工作流、修改参数、提交任务、等待结果。下面介绍核心类和常用参数。4.1 客户端初始化客户端是访问 ComfyUI 服务端的入口需要指定服务端地址和端口from comfyui_tools import ComfyUIClient client ComfyUIClient( base_urlhttp://127.0.0.1:8188, timeout60 )主要参数说明参数名类型说明base_urlstrComfyUI 服务端地址默认 http://127.0.0.1:8188timeoutint请求超时时间单位秒默认 60max_retriesint请求失败时的最大重试次数默认 34.2 工作流加载与参数注入工作流可以从 JSON 文件加载也可以直接传入字典对象。参数注入通过节点 ID 定位并修改对应字段workflow client.load_workflow(workflow.json) client.set_node_param(workflow, node_id3, param_nametext, param_valuea cute cat) client.set_node_param(workflow, node_id4, param_nameseed, param_value42) client.set_node_param(workflow, node_id5, param_namesteps, param_value30)常用方法参数说明方法参数说明load_workflowpath工作流 JSON 文件路径set_node_paramworkflow, node_id, param_name, param_value按节点 ID 修改指定参数get_node_paramworkflow, node_id, param_name读取节点指定参数值4.3 任务提交与结果获取提交任务后返回任务 ID通过任务 ID 轮询执行状态并获取结果task_id client.submit_workflow(workflow) result client.wait_for_result(task_id, timeout120) images result.get(images, []) for img in images: client.save_image(img, output_diroutputs)wait_for_result 返回的 result 字典包含生成图片的元数据save_image 支持保存到本地目录或返回 Base64 字符串。5. 9 个实际应用案例案例 1文生图基础调用使用默认工作流生成一张猫的图片并保存到本地from comfyui_tools import ComfyUIClient client ComfyUIClient(base_urlhttp://127.0.0.1:8188) workflow client.load_workflow(txt2img.json) client.set_node_param(workflow, 3, text, a cute orange cat) client.set_node_param(workflow, 4, seed, 12345) task_id client.submit_workflow(workflow) result client.wait_for_result(task_id) for img in result[images]: client.save_image(img, outputs/cat.png) print(生成完成)案例 2图生图处理加载本地图片作为输入通过图生图工作流生成风格化版本from comfyui_tools import ComfyUIClient client ComfyUIClient() workflow client.load_workflow(img2img.json) client.set_node_param(workflow, 1, image, input/photo.jpg) client.set_node_param(workflow, 3, text, watercolor style) client.set_node_param(workflow, 4, denoise, 0.6) task_id client.submit_workflow(workflow) result client.wait_for_result(task_id) client.save_image(result[images][0], outputs/watercolor.png)案例 3批量生成多张图片循环修改种子和提示词批量生成 5 张不同风格的图片from comfyui_tools import ComfyUIClient client ComfyUIClient() workflow client.load_workflow(txt2img.json) prompts [sunset beach, mountain lake, city night, forest fog, desert dunes] for i, prompt in enumerate(prompts): client.set_node_param(workflow, 3, text, prompt) client.set_node_param(workflow, 4, seed, 1000 i) task_id client.submit_workflow(workflow) result client.wait_for_result(task_id) client.save_image(result[images][0], foutputs/batch_{i}.png) print(f第 {i1} 张生成完成)案例 4动态调整采样参数通过修改 steps、cfg 和 sampler 参数对比不同采样配置的效果from comfyui_tools import ComfyUIClient client ComfyUIClient() workflow client.load_workflow(txt2img.json) configs [ {steps: 20, cfg: 7.0, sampler: euler}, {steps: 30, cfg: 8.0, sampler: dpmpp_2m}, {steps: 40, cfg: 9.0, sampler: uni_pc}, ] for idx, cfg in enumerate(configs): client.set_node_param(workflow, 4, steps, cfg[steps]) client.set_node_param(workflow, 4, cfg, cfg[cfg]) client.set_node_param(workflow, 4, sampler_name, cfg[sampler]) task_id client.submit_workflow(workflow) result client.wait_for_result(task_id) client.save_image(result[images][0], foutputs/sampler_{idx}.png)案例 5读取中间节点输出在调试工作流时读取某个中间节点的输出结果from comfyui_tools import ComfyUIClient client ComfyUIClient() workflow client.load_workflow(debug_workflow.json) task_id client.submit_workflow(workflow) result client.wait_for_result(task_id) 读取节点 ID 为 10 的中间输出 node_output client.get_node_output(result, node_id10) print(中间节点输出:, node_output)案例 6队列状态查询与清理查询当前队列状态并在必要时清空队列from comfyui_tools import ComfyUIClient client ComfyUIClient() queue_info client.get_queue_status() print(当前队列:, queue_info) 清空队列 client.clear_queue() print(队列已清空)案例 7中断当前任务当任务执行时间过长或需要紧急停止时可以中断当前任务from comfyui_tools import ComfyUIClient client ComfyUIClient() workflow client.load_workflow(txt2img.json) task_id client.submit_workflow(workflow) 模拟等待一段时间后中断 import time time.sleep(5) client.interrupt_task() print(任务已中断)案例 8批量处理多张输入图片遍历本地目录中的多张图片逐张进行图生图处理import os from comfyui_tools import ComfyUIClient client ComfyUIClient() workflow client.load_workflow(img2img.json) input_dir inputs output_dir outputs os.makedirs(output_dir, exist_okTrue) for filename in os.listdir(input_dir): if not filename.endswith((.jpg, .png)): continue input_path os.path.join(input_dir, filename) client.set_node_param(workflow, 1, image, input_path) client.set_node_param(workflow, 3, text, anime style) task_id client.submit_workflow(workflow) result client.wait_for_result(task_id) out_name fanime_{filename} client.save_image(result[images][0], os.path.join(output_dir, out_name)) print(f已处理 {filename})案例 9结合随机种子生成创意图片使用随机种子和多样化提示词生成一组创意图片用于灵感收集import random from comfyui_tools import ComfyUIClient client ComfyUIClient() workflow client.load_workflow(txt2img.json) style_keywords [cyberpunk, steampunk, minimalist, surreal, vintage] for i in range(10): style random.choice(style_keywords) subject random.choice([robot, city, forest, ocean, space]) prompt f{style} {subject}, highly detailed seed random.randint(1, 999999) client.set_node_param(workflow, 3, text, prompt) client.set_node_param(workflow, 4, seed, seed) task_id client.submit_workflow(workflow) result client.wait_for_result(task_id) client.save_image(result[images][0], foutputs/creative_{i}.png) print(f生成创意图片 {i1}: {prompt})/code/pre 6. 常见错误与使用注意事项 6.1 常见错误 错误类型 可能原因 解决方法 ConnectionError ComfyUI 服务未启动或地址错误 确认服务端地址和端口正确检查服务是否运行 TimeoutError 任务执行时间超过 timeout 设置 增大 timeout 参数或检查工作流是否过于复杂 KeyError 节点 ID 或参数名不存在 核对工作流 JSON 中的节点 ID 和参数名 FileNotFoundError 工作流文件或输入图片路径错误 检查文件路径是否存在使用绝对路径更稳妥 JSONDecodeError 工作流 JSON 格式错误 用 JSON 校验工具检查工作流文件格式 6.2 使用注意事项 服务端必须先行启动调用任何接口前确保 ComfyUI 服务端已启动并监听对应端口。 工作流 JSON 结构要熟悉修改参数前先查看工作流 JSON 中节点的 ID 和字段名避免误改。 合理设置超时时间复杂工作流或高分辨率生成耗时较长建议将 timeout 设置为 120 秒以上。 注意资源占用批量任务会占用大量 GPU 和内存建议控制并发数量避免服务端崩溃。 图片保存路径保存图片时确保输出目录存在否则会报错。 版本兼容性不同版本的 ComfyUI API 可能有差异建议保持 aigc-comfyui-tools 与 ComfyUI 版本匹配。 错误重试机制网络波动时客户端会自动重试但重试次数过多会拖慢任务建议根据实际情况调整 max_retries。 7. 总结 aigc-comfyui-tools 为 Python 开发者提供了一套简洁、稳定的 ComfyUI 调用方案。通过本文介绍的功能、安装方式、核心语法与参数以及 9 个实际案例读者可以快速上手并应用到自己的 AIGC 项目中。在实际使用中注意服务端状态、工作流结构、超时设置和资源管理就能稳定高效地完成批量生成、参数调优和自动化处理等任务。《AI提示工程必知必会》为读者提供了丰富的AI提示工程知识与实战技能主要包括各类提示词的应用如问答式、指令式、状态类、建议式、安全类和感谢类提示词以及如何通过实战演练掌握提示词的使用技巧使用提示词进行文本摘要、改写重述、语法纠错、机器翻译等语言处理任务以及在数据挖掘、程序开发等领域的应用AI在绘画创作上的应用百度文心一言和阿里通义大模型这两大智能平台的特性与功能以及市场调研中提示词的实战应用。通过阅读《AI提示工程必知必会》读者可掌握如何有效利用AI提示工程提升工作效率创新工作流程并在职场中脱颖而出。