ideogram4

Build a structured JSON caption instead of a plain-text prompt, placing the literal string in a text element's text field. Keep rendered strings short (1-3 word headlines plus a subline) and use bounding boxes to control placement.

Use Ideogram 4 when the image needs legible on-image text, exact brand hex colors, or controlled layout via bounding boxes. Use FLUX.2 for text-free atmospheric backgrounds or when you want simple natural-language prompts.

The toolkit uses Ideogram's hosted v4 API, which requires an IDEOGRAM_API_KEY from developer.ideogram.ai in the .env file. Paid API plans include a commercial license, while the self-hostable open weights are non-commercial.

Garbled text usually means the string was buried in a description instead of a text element's text field, or the string is too long. Wrong placement is fixed by adding a bbox in y-first order [y_min, x_min, y_max, x_max] with 0-1000 normalized coordinates.

Add uppercase hex values like #1456F0 to the color_palette field, using per-element palettes to pin colors on specific items like headlines or logos. The global style_description palette supports up to 16 colors and each element up to 5.

Ideogram 4 handles headlines, sublines, and short CTAs well but degrades on paragraphs of body copy. Keep each text element to a short string and split multi-line content into separate elements with their own bounding boxes.