qishizhe/ai-series-comfyui-handbook

Fork 0

Files

T

qishizhe 08b987172c docs: archive workflow construction guide and node reference

2026-11-01 17:12:31 +08:00

15 KiB

Raw Permalink Blame History

当前节点端口速查（自动读取实际接口）

核对：2026-10-31，服务器ComfyUI 0.39.0。39种节点。此附录列接口，功能、连线和应用见主指南。

COMBO是下拉参数；COMFY_AUTOGROW_V3是可增长的一组输入。一个同名数据类型仍需匹配正确模型家族。

CheckpointLoaderSimple

Load Checkpoint

方向	端口/参数	数据类型	默认值/说明
必填输入	`ckpt_name`	COMBO（68项）	—
输出0	`MODEL`	MODEL	—
输出1	`CLIP`	CLIP	—
输出2	`VAE`	VAE	—

UNETLoader

Load Diffusion Model

方向	端口/参数	数据类型	默认值/说明
必填输入	`unet_name`	COMBO（157项）	—
必填输入	`weight_dtype`	COMBO（4项）	—
输出0	`MODEL`	MODEL	—

CLIPLoader

Load CLIP

方向	端口/参数	数据类型	默认值/说明
必填输入	`clip_name`	COMBO（65项）	—
必填输入	`type`	COMBO（29项）	—
可选输入	`device`	COMBO（2项）	—
输出0	`CLIP`	CLIP	—

DualCLIPLoader

Load CLIP (Dual)

方向	端口/参数	数据类型	默认值/说明
必填输入	`clip_name1`	COMBO（65项）	—
必填输入	`clip_name2`	COMBO（65项）	—
必填输入	`type`	COMBO（12项）	—
可选输入	`device`	COMBO（2项）	—
输出0	`CLIP`	CLIP	—

VAELoader

Load VAE

方向	端口/参数	数据类型	默认值/说明
必填输入	`vae_name`	COMBO（40项）	—
输出0	`VAE`	VAE	—

LoadImage

Load Image

方向	端口/参数	数据类型	默认值/说明
必填输入	`image`	COMBO（48项）	—
输出0	`IMAGE`	IMAGE	—
输出1	`MASK`	MASK	—

ImageScale

Upscale Image

方向	端口/参数	数据类型	默认值/说明
必填输入	`image`	IMAGE	—
必填输入	`upscale_method`	COMBO（5项）	—
必填输入	`width`	INT	512
必填输入	`height`	INT	512
必填输入	`crop`	COMBO（2项）	—
输出0	`IMAGE`	IMAGE	—

VAEEncode

VAE Encode

方向	端口/参数	数据类型	默认值/说明
必填输入	`pixels`	IMAGE	—
必填输入	`vae`	VAE	—
输出0	`LATENT`	LATENT	—

VAEDecode

VAE Decode

方向	端口/参数	数据类型	默认值/说明
必填输入	`samples`	LATENT	—
必填输入	`vae`	VAE	—
输出0	`IMAGE`	IMAGE	—

EmptyLatentImage

Empty Latent Image

方向	端口/参数	数据类型	默认值/说明
必填输入	`width`	INT	1024
必填输入	`height`	INT	1024
必填输入	`batch_size`	INT	1
输出0	`LATENT`	LATENT	—

EmptySD3LatentImage

方向	端口/参数	数据类型	默认值/说明
必填输入	`width`	INT	1024
必填输入	`height`	INT	1024
必填输入	`batch_size`	INT	1
输出0	`LATENT`	LATENT	—

CLIPTextEncode

CLIP Text Encode (Prompt)

方向	端口/参数	数据类型	默认值/说明
必填输入	`text`	STRING	—
必填输入	`clip`	CLIP	—
输出0	`CONDITIONING`	CONDITIONING	—

KSampler

方向	端口/参数	数据类型	默认值/说明
必填输入	`model`	MODEL	—
必填输入	`seed`	INT	0
必填输入	`steps`	INT	20
必填输入	`cfg`	FLOAT	8.0
必填输入	`sampler_name`	COMBO（45项）	—
必填输入	`scheduler`	COMBO（9项）	—
必填输入	`positive`	CONDITIONING	—
必填输入	`negative`	CONDITIONING	—
必填输入	`latent_image`	LATENT	—
必填输入	`denoise`	FLOAT	1.0
输出0	`LATENT`	LATENT	—

ModelSamplingAuraFlow

方向	端口/参数	数据类型	默认值/说明
必填输入	`model`	MODEL	—
必填输入	`shift`	FLOAT	1.73
可选输入	`sampling`	COMBO（2项）	flow
输出0	`MODEL`	MODEL	—

LoraLoader

Load LoRA (Model and CLIP)

方向	端口/参数	数据类型	默认值/说明
必填输入	`model`	MODEL	—
必填输入	`clip`	CLIP	—
必填输入	`lora_name`	COMBO（117项）	—
必填输入	`strength_model`	FLOAT	1.0
必填输入	`strength_clip`	FLOAT	1.0
输出0	`MODEL`	MODEL	—
输出1	`CLIP`	CLIP	—

LoraLoaderModelOnly

Load LoRA

方向	端口/参数	数据类型	默认值/说明
必填输入	`model`	MODEL	—
必填输入	`lora_name`	COMBO（117项）	—
必填输入	`strength_model`	FLOAT	1.0
输出0	`MODEL`	MODEL	—

TextEncodeQwenImage21

Text Encode Qwen Image 2.1

方向	端口/参数	数据类型	默认值/说明
必填输入	`clip`	CLIP	—
必填输入	`prompt`	STRING	—
必填输入	`negative_prompt`	STRING	—
必填输入	`resolution`	INT	1024
必填输入	`images`	COMFY_AUTOGROW_V3	可增长输入；展开后逐个接线
可选输入	`vae`	VAE	—
输出0	`positive`	CONDITIONING	—
输出1	`negative`	CONDITIONING	—
输出2	`latent`	LATENT	—

QwenImage21Cache

Qwen Image 2.1 Cache

方向	端口/参数	数据类型	默认值/说明
必填输入	`model`	MODEL	—
必填输入	`device`	COMBO	auto
必填输入	`dtype`	COMBO	default
输出0	`MODEL`	MODEL	—

RandomNoise

方向	端口/参数	数据类型	默认值/说明
必填输入	`noise_seed`	INT	0
输出0	`NOISE`	NOISE	—

BasicGuider

Basic Guider

方向	端口/参数	数据类型	默认值/说明
必填输入	`model`	MODEL	—
必填输入	`conditioning`	CONDITIONING	—
输出0	`GUIDER`	GUIDER	—

KSamplerSelect

方向	端口/参数	数据类型	默认值/说明
必填输入	`sampler_name`	COMBO	—
输出0	`SAMPLER`	SAMPLER	—

BasicScheduler

方向	端口/参数	数据类型	默认值/说明
必填输入	`model`	MODEL	—
必填输入	`scheduler`	COMBO	—
必填输入	`steps`	INT	20
必填输入	`denoise`	FLOAT	1.0
输出0	`SIGMAS`	SIGMAS	—

SamplerCustomAdvanced

方向	端口/参数	数据类型	默认值/说明
必填输入	`noise`	NOISE	—
必填输入	`guider`	GUIDER	—
必填输入	`sampler`	SAMPLER	—
必填输入	`sigmas`	SIGMAS	—
必填输入	`latent_image`	LATENT	—
输出0	`output`	LATENT	—
输出1	`denoised_output`	LATENT	—

MiniMaxH3ImageToVideo

MiniMax H3 Image to Video

方向	端口/参数	数据类型	默认值/说明
必填输入	`clip`	CLIP	—
必填输入	`vae`	VAE	—
必填输入	`prompt`	STRING	—
必填输入	`width`	INT	1344
必填输入	`height`	INT	768
必填输入	`length`	INT	124
可选输入	`first_frame`	IMAGE	—
可选输入	`last_frame`	IMAGE	—
输出0	`positive`	CONDITIONING	—
输出1	`LATENT`	LATENT	—

MiniMaxH3ReferenceToVideo

MiniMax H3 Reference to Video

方向	端口/参数	数据类型	默认值/说明
必填输入	`clip`	CLIP	—
必填输入	`prompt`	STRING	—
必填输入	`width`	INT	1344
必填输入	`height`	INT	768
必填输入	`length`	INT	124
必填输入	`ref_image_size`	COMBO	match
可选输入	`vae`	VAE	—
可选输入	`audio_vae`	VAE	—
可选输入	`ref_images`	COMFY_AUTOGROW_V3	可增长输入；展开后逐个接线
可选输入	`ref_videos`	COMFY_AUTOGROW_V3	可增长输入；展开后逐个接线
可选输入	`ref_video_audios`	COMFY_AUTOGROW_V3	可增长输入；展开后逐个接线
可选输入	`ref_audios`	COMFY_AUTOGROW_V3	可增长输入；展开后逐个接线
输出0	`positive`	CONDITIONING	—
输出1	`LATENT`	LATENT	—

VAEDecodeAudio

VAE Decode Audio

方向	端口/参数	数据类型	默认值/说明
必填输入	`samples`	LATENT	—
必填输入	`vae`	VAE	—
输出0	`AUDIO`	AUDIO	—

CreateVideo

Create Video

方向	端口/参数	数据类型	默认值/说明
必填输入	`images`	IMAGE	—
必填输入	`fps`	FLOAT	30.0
可选输入	`audio`	AUDIO	—
可选输入	`bit_depth`	COMBO	auto
可选输入	`color_space`	COMBO	sRGB
可选输入	`codec`	COMBO	none
输出0	`VIDEO`	VIDEO	—

SaveVideo

Save Video

方向	端口/参数	数据类型	默认值/说明
必填输入	`video`	VIDEO	—
必填输入	`filename_prefix`	STRING	video/ComfyUI
必填输入	`format`	COMFY_DYNAMICCOMBO_V3	—
可选输入	`codec`	COMFY_DYNAMICCOMBO_V3	—
输出0	`video`	VIDEO	—

SaveImage

Save Image

方向	端口/参数	数据类型	默认值/说明
必填输入	`images`	IMAGE	—
必填输入	`filename_prefix`	STRING	ComfyUI
输出0	`images`	IMAGE	—

LoadAudio

Load Audio

方向	端口/参数	数据类型	默认值/说明
必填输入	`audio`	COMBO	—
输出0	`AUDIO`	AUDIO	—

SaveAudioAdvanced

Save Audio (Advanced)

方向	端口/参数	数据类型	默认值/说明
必填输入	`audio`	AUDIO	—
必填输入	`filename_prefix`	STRING	audio/ComfyUI
必填输入	`format`	COMFY_DYNAMICCOMBO_V3	—
输出0	`audio`	AUDIO	—

MiniMaxH3AudioConditioningT8

MiniMax H3 Audio Conditioning (T8)

方向	端口/参数	数据类型	默认值/说明
必填输入	`clip`	CLIP	—
必填输入	`video_vae`	VAE	—
必填输入	`audio_vae`	VAE	—
必填输入	`prompt`	STRING	—
必填输入	`width`	INT	1344
必填输入	`height`	INT	768
必填输入	`length`	INT	124
必填输入	`task_type`	COMBO	auto
必填输入	`audio_mode`	COMBO	lock_source
必填输入	`audio_denoise_strength`	FLOAT	0.35
必填输入	`add_source_as_reference`	BOOLEAN	True
必填输入	`prompt_primary_audio_ordinal`	INT	1
必填输入	`strict_prompt_tags`	BOOLEAN	True
必填输入	`ref_image_size`	COMBO	match
必填输入	`reference_video_policy`	COMBO	official_2_to_15s
可选输入	`drive_audio`	AUDIO	—
可选输入	`final_audio`	AUDIO	—
可选输入	`first_frame`	IMAGE	—
可选输入	`last_frame`	IMAGE	—
可选输入	`ref_images`	COMFY_AUTOGROW_V3	可增长输入；展开后逐个接线
可选输入	`ref_videos`	COMFY_AUTOGROW_V3	可增长输入；展开后逐个接线
可选输入	`ref_video_audios`	COMFY_AUTOGROW_V3	可增长输入；展开后逐个接线
可选输入	`ref_audios`	COMFY_AUTOGROW_V3	可增长输入；展开后逐个接线
可选输入	`allow_above_reference_area`	BOOLEAN	True
可选输入	`semantic_bridge`	T8_SEMANTIC_BRIDGE	—
输出0	`positive`	CONDITIONING	—
输出1	`av_latent`	LATENT	—
输出2	`mux_audio`	AUDIO	—
输出3	`conditioned_prompt`	STRING	—
输出4	`media_map_json`	STRING	—
输出5	`report`	STRING	—

MiniMaxMusic3TextEncode

MiniMax Music3 Text Encode

方向	端口/参数	数据类型	默认值/说明
必填输入	`clip`	CLIP	—
必填输入	`caption`	STRING	—
必填输入	`lyrics`	STRING	—
必填输入	`seed`	INT	0
必填输入	`max_duration`	FLOAT	120.0
必填输入	`cfg_scale`	FLOAT	1.5
必填输入	`top_k`	INT	50
输出0	`CONDITIONING`	CONDITIONING	—
输出1	`seconds`	FLOAT	—

EmptyMiniMaxMusic3LatentAudio

Empty MiniMax Music3 Latent Audio

方向	端口/参数	数据类型	默认值/说明
必填输入	`seconds`	FLOAT	120.0
必填输入	`batch_size`	INT	1
输出0	`LATENT`	LATENT	—

ConditioningZeroOut

Conditioning Zero Out

方向	端口/参数	数据类型	默认值/说明
必填输入	`conditioning`	CONDITIONING	—
输出0	`CONDITIONING`	CONDITIONING	—

ControlNetLoader

Load ControlNet Model

方向	端口/参数	数据类型	默认值/说明
必填输入	`control_net_name`	COMBO（34项）	—
输出0	`CONTROL_NET`	CONTROL_NET	—

ControlNetApplyAdvanced

Apply ControlNet

方向	端口/参数	数据类型	默认值/说明
必填输入	`positive`	CONDITIONING	—
必填输入	`negative`	CONDITIONING	—
必填输入	`control_net`	CONTROL_NET	—
必填输入	`image`	IMAGE	—
必填输入	`strength`	FLOAT	1.0
必填输入	`start_percent`	FLOAT	0.0
必填输入	`end_percent`	FLOAT	1.0
可选输入	`vae`	VAE	—
输出0	`positive`	CONDITIONING	—
输出1	`negative`	CONDITIONING	—

LoadVideo

Load Video

方向	端口/参数	数据类型	默认值/说明
必填输入	`file`	COMBO	—
输出0	`VIDEO`	VIDEO	—

GetVideoComponents

Get Video Components

方向	端口/参数	数据类型	默认值/说明
必填输入	`video`	VIDEO	—
输出0	`images`	IMAGE	—
输出1	`audio`	AUDIO	—
输出2	`fps`	FLOAT	—
输出3	`bit_depth`	COMBO	—
输出4	`color_space`	COMBO	—

15 KiB Raw Permalink Blame History Unescape Escape