> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# 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 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](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HunyuanImageTextToImageApi/en.md)
***
**Source fingerprint (SHA-256):** `1d4e70d688c5aa4e79b81447da559e201078454077da34769f2a4f544fbba63f`