HunyuanImageTextToImageApi - ComfyUI Built-in Node Documentation

The Tencent HY Image: Text to Image node generates an image from a text description with Tencent’s Hunyuan Image model. The prompt is sent to the API, which rewrites and expands it before rendering, and the finished image is returned as an image batch.

Inputs

Common Inputs

Parameter	Description	Data Type	Required	Range
`model`	The model used for generation. The selected model determines which additional inputs are shown.	DYNAMIC_COMBO	Yes	`"hy-image-3.5-preview"`

hy-image-3.5-preview Inputs

Parameter	Description	Data Type	Required	Range
`prompt`	Describes the image to generate. The model rewrites and expands it before rendering. Must not be empty (default: empty).	STRING	Yes	Any text
`aspect_ratio`	Aspect ratio of the output. `"auto"` lets the model pick the ratio from the prompt and is not available at 4K. Ignored when `resolution` is `"custom"`.	COMBO	Yes	`"auto"` `"1:1"` `"3:2"` `"2:3"` `"4:3"` `"3:4"` `"16:9"` `"9:16"` `"21:9"` `"9:21"` (default: `"auto"`)
`resolution`	Pixel area of the image: 1K is about 1024x1024, 2K about 2048x2048 and 4K about 4096x4096. Anything above 2K is rendered at 2K and upscaled by the model. Set to `"custom"` to use `width` and `height` instead of a preset area.	COMBO	Yes	`"1K"` `"2K"` `"4K"` `"custom"` (default: `"2K"`)
`width`	Width of the image in pixels. Used only when `resolution` is `"custom"`.	INT	Yes	256-8192, steps of 16 (default: 2048)
`height`	Height of the image in pixels. Used only when `resolution` is `"custom"`.	INT	Yes	256-8192, steps of 16 (default: 2048)
`seed`	Seed used for generation. Results still vary between runs with the same seed.	INT	Yes	0-2147483647 (default: 42)
`watermark`	Whether to add an AI-generated watermark to the result. This is an advanced parameter.	BOOLEAN	No	true false (default: false)

prompt must not be empty. With the "custom" resolution, width and height must both be multiples of 16 and their product must not exceed the 4096 x 4096 pixel area limit (about 16.7 megapixels); any aspect ratio works, although beyond roughly 6:1 the model starts repeating the subject. The "auto" aspect ratio needs the model to choose a size, so it only works within the 2K area limit: at 4K, pick an explicit aspect ratio or use "custom".

Outputs

Output Name	Description	Data Type
`IMAGE`	The generated image.	IMAGE

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

Source fingerprint (SHA-256): 1d4e70d688c5aa4e79b81447da559e201078454077da34769f2a4f544fbba63f

​Inputs

​Common Inputs

​hy-image-3.5-preview Inputs

​Outputs

Inputs

Common Inputs

hy-image-3.5-preview Inputs

Outputs