> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-custom-nodes-sdk-v2-frontend.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# RecraftV4TextToImageNode - ComfyUI Built-in Node Documentation

> Recraft V4 Text to Image

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"<br />"recraftv4\_1\_utility"<br />"recraftv4\_1\_pro"<br />"recraftv4\_1\_utility\_pro"<br />"recraftv4"<br />"recraftv4\_pro"<br />"recraftv4\_styles"<br />"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"<br />"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](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/RecraftV4TextToImageNode/en.md)

***

**Source fingerprint (SHA-256):** `af5c1f68e59ca282cdca7c32cd50f0438b743fdda27d9d22e59b2d1343f45e26`
