IdeogramPImage - ComfyUI Built-in Node Documentation

Ideogram P-Image generates images from a text prompt using Ideogram’s fast text-to-image model, which is known for strong typography and photorealism. It also supports Ideogram 4.0 structured JSON captions for exact control over text strings, colors, and layout. The node returns the generated image(s) along with the final prompt the image was actually generated from.

Inputs

Parameter	Description	Data Type	Required	Range
`prompt`	Text prompt. Also accepts an Ideogram 4.0 structured JSON caption (exact colors as #RRGGBB hexes, exact text strings, bounding-box layout) — set prompt_upsampling to OFF to use it verbatim. Must not be empty. (default: "")	STRING	Yes	Any text
`quality`	Speed/price/quality tier. MEDIUM is the everyday default; HIGH for complex prompts, fine detail and difficult text; VERY_LOW/LOW for drafts at scale. Difficult text renders poorly below MEDIUM. (default: “MEDIUM”)	STRING	Yes	”VERY_LOW" "LOW" "MEDIUM" "HIGH”
`resolution`	Output size class (exact pixels follow the aspect ratio, e.g. 16:9 gives 1280x720 at 1K and 2560x1440 at 2K). Prefer HIGH + 2K for crisp typography. (default: “1K”)	STRING	Yes	”1K" "2K”
`aspect_ratio`	The aspect ratio for image generation. (default: “1:1”)	STRING	Yes	”1:3" "3:1" "1:2" "2:1" "9:16" "16:9" "10:16" "16:10" "2:3" "3:2" "3:4" "4:3" "4:5" "5:4" "1:1”
`prompt_upsampling`	Expands short prompts into a detailed structured caption before generation (the rewritten prompt is returned as final_prompt). Set OFF when supplying your own JSON caption or exact wording. (default: “AUTO”)	STRING	Yes	”AUTO" "ON" "OFF”
`seed`	Seed for reproducible generation. With prompt_upsampling OFF, the same seed and settings return the same image; with ON/AUTO the prompt rewrite varies per run — reproduce a result by reusing its final_prompt output with prompt_upsampling OFF and the same seed. (default: 42)	INT	No	0 to 2147483647

Note on constraints: The prompt must contain at least one non-whitespace character, otherwise the node fails. Set prompt_upsampling to OFF when supplying your own structured JSON caption or exact wording. When prompt_upsampling is ON or AUTO, the prompt is rewritten before generation, so the same seed may not reproduce the same image; to reproduce an image, reuse its final_prompt output with prompt_upsampling OFF and the same seed.

Outputs

Output Name	Description	Data Type
`image`	The generated image(s) returned as a batch of images. If Ideogram’s content safety filter blocks the generation, an error is raised instead.	IMAGE
`final_prompt`	The prompt the image was actually generated from (the rewritten structured caption when prompt_upsampling ran, else your prompt). Feed it back with prompt_upsampling OFF and the same seed to reproduce this image.	STRING

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

Source fingerprint (SHA-256): 7bd20aae508fee111ded32e87119ed6fc01c5ad5ba7d595e24391830a0f20bb7

​Inputs

​Outputs

Inputs

Outputs