RecraftV4TextToImageNode - ComfyUI Built-in Node Documentation

Recraft V4 Text to Image This node generates images from text descriptions using the Recraft V4 and V4.1 AI models. It sends your prompt to an external API and returns the generated images. You can control the output by specifying the model, image size, number of images, and an optional style, either as a saved style ID or from reference images.

Inputs

Common Inputs

Parameter	Description	Data Type	Required	Range
`model`	The model to use for generation. The recraftv4_styles models are built for style-consistent generation and always require a style_id or style_references.	DYNAMIC_COMBO	Yes	”recraftv4_1" "recraftv4_1_utility" "recraftv4_1_pro" "recraftv4_1_utility_pro" "recraftv4" "recraftv4_pro" "recraftv4_styles" "recraftv4_styles_pro”
`prompt`	Prompt for the image generation. Maximum 10,000 characters.	STRING	Yes	1 to 10000 characters
`negative_prompt`	This input is ignored: negative prompt is not supported by Recraft V4 and V4.1 models.	STRING	Yes	N/A
`n`	The number of images to generate (default: 1).	INT	Yes	1 to 6
`seed`	Seed to determine if node should re-run; actual results are nondeterministic regardless of seed (default: 0).	INT	Yes	0 to 18446744073709551615
`recraft_controls`	Optional additional controls over the generation via the Recraft Controls node.	CUSTOM	No	N/A
`style_id`	UUID of a Recraft V4 style to apply, e.g. from the Recraft V4 Create Style node or the style_id output of a previous run. Cannot be combined with style_references (default: empty).	STRING	No	Valid UUID string
`style_match`	How closely to follow the style: precise reproduces it in detail, flexible matches the general look. Only used when a style is provided (default: “precise”).	COMBO	No	”precise" "flexible”

recraftv4_1, recraftv4_1_utility, recraftv4, and recraftv4_styles Inputs

These models share the same size parameter.

Parameter	Description	Data Type	Required	Range
`size`	The size of the generated image (default: “1024x1024”).	COMBO	Yes	Multiple options available (standard Recraft V4 sizes, includes “1024x1024”)

recraftv4_1_pro, recraftv4_1_utility_pro, recraftv4_pro, and recraftv4_styles_pro Inputs

These models share the same size parameter.

Parameter	Description	Data Type	Required	Range
`size`	The size of the generated image (default: “2048x2048”).	COMBO	Yes	Multiple options available (pro Recraft V4 sizes, includes “2048x2048”)

Reference Inputs

Parameter	Description	Data Type	Required	Range
`style_references`	Reference images to create a style from on the fly, billed on top of the generation. The created style is returned as style_id for reuse. Cannot be combined with style_id. Growable slot: connect 1..N images (style_reference_1, style_reference_2, …).	IMAGE	No	0 to the maximum number of reference images allowed by the Recraft API; total encoded size must not exceed 10 MB

Note: The size parameter is a dynamic input whose available options change based on the selected model. The recraftv4_styles and recraftv4_styles_pro models always require a style: connect style reference images or provide a style_id. The style_id and style_references inputs are mutually exclusive — provide only one of them. A style_id must be a valid UUID. The style_match input is only used when a style is provided. Style reference images are billed on top of the generation and their total encoded size must not exceed 10 MB. The seed value does not guarantee reproducible image outputs. If you use a style ID from the Infinite Style Library, make sure it is not a Vector art style, as this may return SVG data instead of an image.

Outputs

Output Name	Description	Data Type
`output`	The generated image or batch of images.	IMAGE
`style_id`	The style ID used or created by this generation. When style reference images are provided, the created style is returned here for reuse; empty string when no style is used.	STRING

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): af5c1f68e59ca282cdca7c32cd50f0438b743fdda27d9d22e59b2d1343f45e26

​Inputs

​Common Inputs

​recraftv4_1, recraftv4_1_utility, recraftv4, and recraftv4_styles Inputs

​recraftv4_1_pro, recraftv4_1_utility_pro, recraftv4_pro, and recraftv4_styles_pro Inputs

​Reference Inputs

​Outputs