ComfyPilotComfyPilot
文档 / 节点说明 / Ideogram 4.5 文本转图像

Ideogram 4.5 文本转图像

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

节点说明 IdeogramTextToImageApi 更新于 2026-11-12

查看官方原文

Ideogram 4.5 文本转图像 - ComfyUI Built-in Node Documentation

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

使用 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