ComfyUI Node

Ideogram 4.0

The text-in-image champ, with its own prompt schema

By Runware·Created 2 years ago·Updated about a month ago· 140
Ideogram 4.0
  • advancedFeatures.watermark.image
  • image
settings.structuredPrompt.high_level_description
positivePrompt
size2K (1:1)
numberResults1
advancedFeaturesfalse
advancedFeatures.watermark.bgColor
advancedFeatures.watermark.displayPosition(default)
advancedFeatures.watermark.fontColor
advancedFeatures.watermark.opacityfalse
advancedFeatures.watermark.opacity_value0.10
advancedFeatures.watermark.text
settings.structuredPrompt.style_description.aesthetics
settings.structuredPrompt.style_description.art_style
settings.structuredPrompt.compositional_deconstruction.background
settings.copyrightDetectionfalse
settings.structuredPrompt.style_description.lighting
settings.structuredPrompt.style_description.medium
settings.structuredPrompt.style_description.photo
settings.renderingSpeedDEFAULT
safetyfalse
safety.checkContentfalse
ttlfalse
ttl_value60
outputFormatJPG
outputQuality95
advanced_json

If you've ever needed an image that contains legible text - a poster, a logo, a sign - you know Ideogram is the model that made it look easy while everything else mangled letters into eldritch runes. Ideogram 4.0 (ideogram:4@0) is the current generation, and this node runs it on Runware's cloud. But here's the thing that will decide whether you love or hate this node: Ideogram 4 doesn't take a plain prompt. It takes a structured prompt, and the node's required input is settings.structuredPrompt.high_level_description - one or two sentences describing the full image, subject and style included.

That's not bureaucracy for its own sake. Ideogram's structured prompt is the model's actual input format, and the reason its text rendering and composition are so good. The node lets you write the high-level description and optionally fill the structured slots: art_style, medium, photo (photographic style), aesthetics, lighting, and compositional_deconstruction.background. The plain positivePrompt field exists as a convenience - the tooltip says it's automatically expanded into a structured prompt before generation. So you can start plain and go structured when you need control.

How it works, and the licensing elephant

Ideogram 4 is open weights, but it shipped with a non-commercial license and a trained-in safety filter that emits a refusal image instead of your prompt. On this node, the copyrightDetection toggle opts into post-generation Hive likeness-and-logo checks. The takeaway: this is a fantastic model for personal work and internal design iteration, and a legal minefield for commercial use - check the license before you put it in a client deliverable.

Inputs that matter

  • settings.structuredPrompt.high_level_description (required) - your one-or-two-sentence spec. This is the single most important input on the node.
  • settings.structuredPrompt.style_description.art_style / medium / photo / aesthetics / lighting - the structured slots; the more you fill, the more deterministic the output.
  • settings.structuredPrompt.compositional_deconstruction.background - environment, framing, lighting context.
  • positivePrompt - freeform prompt, auto-expanded into the structured format. Easiest start; the structured fields override when set.
  • renderingSpeed - DEFAULT/speed-quality tradeoff dropdown.
  • width / height (1024 default), numberResults (1–20), safety gate, outputFormat/outputQuality, and advanced_json for the slots without dedicated widgets (the tooltip mentions compositional_deconstruction.elements and color_palette fields).

The image output is a native IMAGE into Preview or Save, cost on the title bar.

Where people get burned

  • The required field is a structured slot, not the prompt box. New users type into positivePrompt, leave high_level_description empty, and get a "required input" wall. The required one is the structured description.
  • Licensing, again. Non-commercial. The model's the best text renderer in the pack and it's also the one you can't ship with. That's Ideogram's whole controversy in one sentence.
  • The safety filter is trained in. If your prompt trips it, you get a refusal image, not an error - the node can't route around what's baked into the weights.
  • Structured vs. freeform - mixing both is fine (structured fields win), but if you're getting results that ignore your positivePrompt, it's because the structured slots are carrying the weight.

Ideogram 4 is the node you reach for when the text has to be right and the license allows it. For everything else, an open Apache-2.0 model will get you most of the way without the fine print.

CategoryRunware/Image/ideogram

Inputs (27)

NameTypeDefaultDescription
settings.structuredPrompt.high_level_descriptionSTRINGOne or two sentences describing the full image, including subject and style.
advancedFeatures.watermark.imageoptIMAGE
positivePromptoptSTRINGText prompt describing elements to include in the generated output. Automatically expanded into a structured prompt before generation.
sizeoptCOMBO2K (1:1)Output size. Only one of resolution or dimensions is sent.
numberResultsoptINT11–20Number of results to generate. Each result uses a different seed, producing variations of the same parameters.
advancedFeaturesoptBOOLEANfalseEnable to set advancedFeatures. Off uses the model's default.
advancedFeatures.watermark.bgColoroptSTRINGBackground color in hex format.
advancedFeatures.watermark.displayPositionoptCOMBO(default)Watermark position.
advancedFeatures.watermark.fontColoroptSTRINGText color in hex format.
advancedFeatures.watermark.opacityoptBOOLEANfalseEnable to set advancedFeatures.watermark.opacity. Off uses the model's default.
advancedFeatures.watermark.opacity_valueoptFLOAT0.100.1–1Watermark opacity.
advancedFeatures.watermark.textoptSTRINGWatermark text.
settings.structuredPrompt.style_description.aestheticsoptSTRINGOverall aesthetic direction.
settings.structuredPrompt.style_description.art_styleoptSTRINGArt style for non-photographic images.
settings.structuredPrompt.compositional_deconstruction.backgroundoptSTRINGEnvironment, framing, and lighting context.
settings.copyrightDetectionoptBOOLEANfalseOpt into post-generation copyright detection using Hive likeness and logo checks.
settings.structuredPrompt.style_description.lightingoptSTRINGLighting setup and mood.
settings.structuredPrompt.style_description.mediumoptSTRINGArtistic medium or capture format.
settings.structuredPrompt.style_description.photooptSTRINGPhotographic style for photo-realistic images.
settings.renderingSpeedoptCOMBODEFAULTGeneration speed/quality tradeoff.
safetyoptBOOLEANfalseEnable to set safety. Off uses the model's default.
safety.checkContentoptBOOLEANfalseEnable or disable content safety checking.
ttloptBOOLEANfalseEnable to set ttl. Off uses the model's default.
ttl_valueoptINT60Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`.
outputFormatoptCOMBOJPGFile format for the generated image.
outputQualityoptINT9520–99Compression quality of the output. Higher values preserve quality but increase file size.
advanced_jsonoptSTRINGOptional JSON merged into the request. For: settings.structuredPrompt.compositional_deconstruction.elements, settings.structuredPrompt.style_description.color_palette

Outputs (1)

NameTypeDescription
imageIMAGE