IdeogramTextToImageApi - ComfyUI Built-in Node Documentation - ComfyUI

使用 Ideogram 4.5 根据文本提示词生成图像。提示词也可以接受 Ideogram 结构化 JSON 描述（caption），例如先前某次运行返回的 final_prompt，它可精确控制文本字符串、颜色和布局。此节点返回生成的图像，以及图像实际生成时所依据的描述。

输入

参数	描述	数据类型	必填	取值范围
`模型`	要使用的模型。（默认值：`"ideogram-4.5"`）	DYNAMIC_COMBO	是	`"ideogram-4.5"`
`prompt`	文本提示词，或 Ideogram 结构化 JSON 描述，例如之前的 `final_prompt`。（默认值：空字符串）	STRING	是	1 到 10000 个字符
`size`	输出尺寸。`"auto"` 让模型选择适合该提示词的画布。`(2K)` 或 `(1K)` 预设会同时固定像素尺寸和宽高比。（默认值：`"auto"`）	COMBO	是	`"auto"` `"(2K) 2048x2048 (1:1)"` `"(2K) 1440x2880 (1:2)"` `"(2K) 2880x1440 (2:1)"` `"(2K) 1664x2496 (2:3)"` `"(2K) 2496x1664 (3:2)"` `"(2K) 1792x2240 (4:5)"` `"(2K) 2240x1792 (5:4)"` `"(2K) 1440x2560 (9:16)"` `"(2K) 2560x1440 (16:9)"` `"(2K) 1600x2560 (5:8)"` `"(2K) 2560x1600 (8:5)"` `"(2K) 1728x2304 (3:4)"` `"(2K) 2304x1728 (4:3)"` `"(2K) 1296x3168 (9:22)"` `"(2K) 3168x1296 (22:9)"` `"(2K) 1152x2944 (9:23)"` `"(2K) 2944x1152 (23:9)"` `"(2K) 1248x3328 (3:8)"` `"(2K) 3328x1248 (8:3)"` `"(2K) 1280x3072 (5:12)"` `"(2K) 3072x1280 (12:5)"` `"(2K) 1024x3072 (1:3)"` `"(2K) 3072x1024 (3:1)"` `"(1K) 1024x1024 (1:1)"` `"(1K) 896x1120 (4:5)"` `"(1K) 1120x896 (5:4)"` `"(1K) 864x1152 (3:4)"` `"(1K) 1152x864 (4:3)"` `"(1K) 832x1248 (2:3)"` `"(1K) 1248x832 (3:2)"` `"(1K) 800x1280 (5:8)"` `"(1K) 1280x800 (8:5)"` `"(1K) 720x1280 (9:16)"` `"(1K) 1280x720 (16:9)"` `"(1K) 720x1440 (1:2)"` `"(1K) 1440x720 (2:1)"`
`quality`	质量档位。档位越高，成本越高、耗时越长。（默认值：`"medium"`）	COMBO	是	`"low"` `"medium"` `"high"`
`magic_prompt`	在生成之前将提示词重写为详细的结构化描述；`"off"` 会尽可能保留你的原始表述。该描述会作为 `final_prompt` 返回。（默认值：`"auto"`）这是高级设置。	COMBO	是	`"auto"` `"on"` `"off"`
`seed`	生成所用的种子。由于每次运行都会重写提示词，文生图仅凭种子无法复现；要复现某张图像，请复用其 `final_prompt`，将 `magic_prompt` 设为 `"off"`，并使用相同的种子。（默认值：42）	INT	是	0 到 2147483647

参数约束

提示词必填： 提示词必须至少包含一个非空白字符，且最多 10000 个字符。在提供自己的 JSON 描述或精确表述时，请将 magic_prompt 设为 "off"。
尺寸： "auto" 让模型自行选择。(2K) 预设约为 3 至 4 百万像素，(1K) 预设约为 1 百万像素，因此档位标签描述的是像素总量而非固定长边；预设的宽高比会被遵循。只有预设中的像素尺寸部分会发送给 API。
可复现性： 当 magic_prompt 设为 "auto" 或 "on" 时，提示词会在每次运行时被重写，因此相同的种子仍可能生成不同的图像。要复现某张图像，请将其 final_prompt 回传，将 magic_prompt 设为 "off"，并使用相同的种子。
内容安全： 如果 Ideogram 的内容安全过滤器拦截了生成，节点会抛出错误，而不是返回图像。

输出

输出名称	描述	数据类型
`IMAGE`	生成的图像（以批次形式）。	IMAGE
`final_prompt`	图像生成时所依据的结构化描述。将其回传，并将 `magic_prompt` 设为 `"off"`，再使用相同的种子，即可复现该图像。	STRING

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！在 GitHub 上编辑

Source fingerprint (SHA-256): a21f1faed9ca7a7bc63dae74003cc7599f11013075f718af9e5860d2cd666828