SuperAPI AI 工具集

comfyui-node-datatypes

编程与开发

查看项目

更新于 10-16 09:57

技能介绍

用途:面向开发 ComfyUI 自定义节点时的数据类型参考,帮助理解各类型在节点输入输出中的张量形状与数据格式。

主要能力:列出张量/数据类型,包括 IMAGE(torch.Tensor [B,H,W,C],float32 0-1)、MASK([H,W] 或 [B,H,W])、LATENT(samples 为 4D 图像或 5D 视频,另含 noise_mask、batch_index、type 等可选键)、CONDITIONING(list[tuple[Tensor, PooledDict]])、AUDIO、VIDEO、SIGMAS、NOISE、LORA_MODEL、LOSS_MAP、TRACKS 等;模型类型如 MODEL、CLIP、VAE、CONTROL_NET 多为透传;3D 类型涵盖 MESH、VOXEL、SPLAT 及 GLB、GLTF、FBX、OBJ、STL、USDZ、PLY 等 File3D 格式;控件类型含 INT、FLOAT、STRING、BOOLEAN、COMBO、COLOR、BOUNDING_BOX、CURVE、RANGE、Webcam 等;特殊类型含 AnyType、MultiType、MatchType、Autogrow、DynamicCombo。

使用方式:以 io.Image.Input/Output 等声明输入输出;图像可用 PIL 与 numpy 在文件和张量间转换;LATENT 修改时用 copy() 保留额外键;条件可通过列表拼接合并;自定义类型可用 io.Custom 或 @comfytype 装饰器;导入来自 comfy_api.latest。

适用场景:编写或调试 ComfyUI 自定义节点、处理图像/潜空间/条件/音视频/3D 数据及类型转换。

限制:部分类型为抽象或不透明透传,DynamicSlot 尚未被核心节点使用,FLOW_CONTROL 与 ACCUMULATION 仅内部测试;判断张量时须用 is not None,不可用真值判断。具体版本差异与更细的模型专属键资料未完全展开。