> ## 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

> 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`