> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-claude-comfy-concurrency-limits-page-s84u33.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# HunyuanImageTextToImageApi - ComfyUI Built-in Node Documentation

> Tencent HY Image: Text to Image 节点使用腾讯的 Hunyuan Image 模型，根据文本描述生成图像。

Tencent HY Image: Text to Image 节点使用腾讯的 Hunyuan Image 模型，根据文本描述生成图像。提示词会发送到 API，API 会在渲染前对其进行重写和扩展，最终图像以图像批次返回。

## 输入

### 通用输入

| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| - | - | - | - | - |
| `模型` | 用于生成的模型。所选模型决定显示哪些额外输入。 | DYNAMIC\_COMBO | 是 | `"hy-image-3.5-preview"` |

### hy-image-3.5-preview 输入

| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| - | - | - | - | - |
| `prompt` | 描述要生成的图像。模型会在渲染前对其进行重写和扩展。不能为空（默认：空）。 | STRING | 是 | 任意文本 |
| `aspect_ratio` | 输出的宽高比。`"auto"` 让模型根据提示词选择比例，且在 4K 下不可用。当 `resolution` 为 `"custom"` 时忽略。 | COMBO | 是 | `"auto"`<br />`"1:1"`<br />`"3:2"`<br />`"2:3"`<br />`"4:3"`<br />`"3:4"`<br />`"16:9"`<br />`"9:16"`<br />`"21:9"`<br />`"9:21"`（默认：`"auto"`） |
| `resolution` | 图像的像素面积：1K 约为 1024x1024，2K 约为 2048x2048，4K 约为 4096x4096。高于 2K 的内容会以 2K 渲染，并由模型放大。设置为 `"custom"` 以使用 `width` 和 `height`，而不是预设面积。 | COMBO | 是 | `"1K"`<br />`"2K"`<br />`"4K"`<br />`"custom"`（默认：`"2K"`） |
| `width` | 图像宽度（像素）。仅当 `resolution` 为 `"custom"` 时使用。 | INT | 是 | 256-8192，步长为 16（默认：2048） |
| `height` | 图像高度（像素）。仅当 `resolution` 为 `"custom"` 时使用。 | INT | 是 | 256-8192，步长为 16（默认：2048） |
| `seed` | 用于生成的种子。即使使用相同的种子，不同运行之间的结果仍会变化。 | INT | 是 | 0-2147483647（默认：42） |
| `watermark` | 是否向结果添加 AI 生成的水印。这是一个高级参数。 | BOOLEAN | 否 | true<br />false（默认：false） |

`prompt` 不能为空。使用 `"custom"` 分辨率时，`width` 和 `height` 都必须是 16 的倍数，且它们的乘积不能超过 4096 x 4096 像素面积限制（约 16.7 百万像素）；任何宽高比都可以，不过超过约 6:1 后，模型会开始重复主体。`"auto"` 宽高比需要模型选择尺寸，因此仅在 2K 面积限制内有效：在 4K 下，请选择明确的宽高比或使用 `"custom"`。

## 输出

| 输出名称 | 描述 | 数据类型 |
| - | - | - |
| `IMAGE` | 生成的图像。 | IMAGE |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HunyuanImageTextToImageApi/zh.md)

***

**Source fingerprint (SHA-256):** `1d4e70d688c5aa4e79b81447da559e201078454077da34769f2a4f544fbba63f`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.