> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# IdeogramPImage - ComfyUI Built-in Node Documentation

> Complete documentation for the IdeogramPImage node in ComfyUI. Learn its inputs, outputs, parameters and usage.

Ideogram P-Image 使用 Ideogram 的高速文本到图像模型，根据文本提示生成图像，该模型以强大的排版和逼真效果著称。它还支持 Ideogram 4.0 结构化 JSON 字幕，可精确控制文本字符串、颜色和布局。此节点返回生成的图像以及实际用于生成图像的最后提示词。

## 输入

| 参数                  | 描述                                                                                                                                                           | 数据类型   | 必填 | 范围                                                                                                                                                                    |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | -- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `prompt`            | 文本提示。也接受 Ideogram 4.0 结构化 JSON 字幕（精确颜色为 #RRGGBB 十六进制、精确文本字符串、边界框布局）——将 prompt\_upsampling 设为 OFF 以按原样使用。不可为空。（默认：""）                                         | STRING | 是  | 任意文本                                                                                                                                                                  |
| `quality`           | 速度/价格/质量档位。MEDIUM 是日常默认；HIGH 用于复杂提示、精细细节和困难文本；VERY\_LOW/LOW 用于大规模草稿。低于 MEDIUM 时困难文本渲染效果不佳。（默认："MEDIUM"）                                                      | STRING | 是  | "VERY\_LOW"<br />"LOW"<br />"MEDIUM"<br />"HIGH"                                                                                                                      |
| `resolution`        | 输出尺寸等级（具体像素取决于宽高比，例如 16:9 在 1K 下为 1280x720，在 2K 下为 2560x1440）。若追求清晰排版，建议使用 HIGH + 2K。（默认："1K"）                                                               | STRING | 是  | "1K"<br />"2K"                                                                                                                                                        |
| `aspect_ratio`      | 图像生成的宽高比。（默认："1:1"）                                                                                                                                          | STRING | 是  | "1:3"<br />"3:1"<br />"1:2"<br />"2:1"<br />"9:16"<br />"16:9"<br />"10:16"<br />"16:10"<br />"2:3"<br />"3:2"<br />"3:4"<br />"4:3"<br />"4:5"<br />"5:4"<br />"1:1" |
| `prompt_upsampling` | 在生成前将简短提示扩展为详细的结构化字幕（重写后的提示会作为 final\_prompt 返回）。在提供自己的 JSON 字幕或精确措辞时设为 OFF。（默认："AUTO"）                                                                      | STRING | 是  | "AUTO"<br />"ON"<br />"OFF"                                                                                                                                           |
| `seed`              | 用于可复现生成的种子。在 prompt\_upsampling 为 OFF 时，相同种子和设置会返回相同图像；在 ON/AUTO 时，提示重写会随每次运行而变化——如需复现结果，可将该图像的 final\_prompt 输出与 prompt\_upsampling OFF 及相同种子一起再次使用。（默认：42） | INT    | 否  | 0 到 2147483647                                                                                                                                                        |

**约束说明：** 提示必须包含至少一个非空白字符，否则节点将失败。在提供自己的结构化 JSON 字幕或精确措辞时，请将 `prompt_upsampling` 设为 OFF。当 `prompt_upsampling` 为 ON 或 AUTO 时，提示会在生成前被重写，因此相同的种子可能无法复现相同的图像；要复现图像，请将 `final_prompt` 输出与 `prompt_upsampling` OFF 及相同种子一起重新使用。

## 输出

| 输出名称           | 描述                                                                                                        | 数据类型   |
| -------------- | --------------------------------------------------------------------------------------------------------- | ------ |
| `image`        | 生成的图像，以图像批次形式返回。如果 Ideogram 的内容安全过滤器阻止了生成，则会引发错误。                                                         | IMAGE  |
| `final_prompt` | 实际用于生成图像的提示（如果 prompt\_upsampling 运行，则为重写后的结构化字幕，否则为您的提示）。将其与 prompt\_upsampling OFF 及相同种子一起反馈回去，即可复现此图像。 | STRING |

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

***

**Source fingerprint (SHA-256):** `7bd20aae508fee111ded32e87119ed6fc01c5ad5ba7d595e24391830a0f20bb7`