SuperAPI AI 工具集

comfyui-node-basics

通用与其它

查看项目

更新于 10-16 06:21

技能介绍

用途:介绍 ComfyUI 自定义节点的 V3 API 基础,用于创建新节点、定义节点类与注册扩展。

主要能力:说明 V3 节点需继承 io.ComfyNode,并实现 define_schema(cls) 与 execute(cls, ...) 两个 classmethod;Schema 字段包括 node_id、display_name、category、description、inputs、outputs、hidden、is_output_node、is_experimental、is_deprecated、is_dev_only、is_api_node、is_input_list、not_idempotent、accept_all_inputs、enable_expand、search_aliases、essentials_category、price_badge、has_intermediate_output 等。输入输出使用 io.Image.Input、io.Float.Input、io.String.Input、io.Image.Output、io.String.Output 等类型,返回 io.NodeOutput(...)。

使用方式:通过 ComfyExtension 与模块级 comfy_entrypoint() 注册,get_node_list 返回节点类列表。示例导入:from comfy_api.latest import ComfyExtension, io。

V1 对照:V1 使用普通类、INPUT_TYPES()、RETURN_TYPES、NODE_CLASS_MAPPINGS 与 NODE_DISPLAY_NAME_MAPPINGS,execute 为实例方法。

规则与限制:node_id 全局唯一;execute 参数须与输入 ID 完全一致;V3 全为 classmethod,无实例状态;返回值数量须匹配输出;category 用 / 表示层级,前缀 _ 可隐藏菜单。

适用场景:编写 ComfyUI 自定义节点、定义节点类、配置输入输出与注册扩展。相关主题包括数据类型、输入、输出、打包与生命周期。具体安装命令与版本要求暂未提供。