> ## 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.
# IdeogramEditApi - ComfyUI Built-in Node Documentation
> Edit or combine up to 5 images guided by a text prompt with Ideogram 4.5.
Edit or combine up to 5 images guided by a text prompt with Ideogram 4.5. Image 1 is the image to edit and the following images are optional references. The whole image is re-rendered, so the size or aspect ratio of the result can change; use Ideogram 4.5 Precise Edit to keep untouched pixels unchanged instead.
## Inputs
| Parameter | Description | Data Type | Required | Range |
| - | - | - | - | - |
| `model` | Model to use. (default: `"ideogram-4.5"`) | DYNAMIC\_COMBO | Yes | `"ideogram-4.5"` |
| `images` | Growable slot: image 1 is the image to edit and images 2 to 5 are optional references (`image_1` ... `image_5`). Refer to them in the prompt as @Image1, @Image2, ...; a batched input counts once per image. Each image must have an aspect ratio between 1:6 and 6:1. | IMAGE | Yes | 1 to 5 images |
| `prompt` | Editing instructions. Supports @Image1-style references to the connected images. (default: empty string) | STRING | Yes | 1 to 10000 characters |
| `size` | Output size. `"auto"` picks a roughly 2K canvas from the images and the prompt, `"source"` keeps the size of image 1 (images above about 4 MP are scaled down first), and a preset with a different aspect ratio recomposes the scene. Select `"custom"` to use the width and height below. (default: `"auto"`) | COMBO | Yes | `"auto"`
`"source"`
`"(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) 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)"`
`"custom"` |
| `width` | Custom output width in pixels. Used only when `size` is `"custom"`. (default: 2048) | INT | Yes | 256 to 4608 (step 32) |
| `height` | Custom output height in pixels. Used only when `size` is `"custom"`. (default: 2048) | INT | Yes | 256 to 4608 (step 32) |
| `quality` | Quality tier. Higher tiers cost more and take longer. (default: `"medium"`) | COMBO | Yes | `"very_low"`
`"low"`
`"medium"`
`"high"` |
| `seed` | Seed for generation. The same images, prompt, settings and seed give the same result. (default: 42) | INT | Yes | 0 to 2147483647 |
### Parameter Constraints
* **Image count:** at least 1 and at most 5 images; a batched input counts once per image. Image 1 is the image to edit, the rest are references.
* **Image aspect ratio:** every image must be no wider than 6x its height and no taller than 6x its width (between 1:6 and 6:1).
* **Prompt tags:** `@ImageN` is matched case-insensitively and must not exceed the number of connected images; the prompt must be non-whitespace and at most 10000 characters.
* **Custom size:** used only when `size` is `"custom"`. The width times height must not exceed 4194304 pixels (2048x2048), and the longer side must not exceed 6x the shorter side. Width and height must be between 256 and 4608 and are snapped to multiples of 32.
* **Upload scaling:** images larger than about 4 MP, or larger than 4608 px on the long side, are scaled down before they are sent.
* **Content safety:** if Ideogram's content safety filter blocks the result, the node raises an error instead of returning an image.
## Outputs
| Output Name | Description | Data Type |
| - | - | - |
| `IMAGE` | The edited or combined image(s) as a batch. | IMAGE |
> 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/IdeogramEditApi/en.md)
***
**Source fingerprint (SHA-256):** `58c189d65502373ff7b56f5f32d9f2e7ee8019fc58f1bbbb80abc859cf978f67`
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.