> ## 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 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"<br />"LOW"<br />"MEDIUM"<br />"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"<br />"2K"                                                                                                                                                        |
| `aspect_ratio`      | The aspect ratio for image generation. (default: "1:1")                                                                                                                                                                                                                               | STRING    | Yes      | "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` | 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"<br />"ON"<br />"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](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/IdeogramPImage/en.md)

***

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