> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-feat-openapi-i18n.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ComfyUI Ideogram 4.0 Open-Source Model Tutorial

> Learn how to use the Ideogram 4.0 open-source model in ComfyUI

Ideogram 4.0 is the latest text-to-image model from Ideogram, released as an open-source model that runs entirely on your own hardware. It delivers superior photorealistic quality, accurate text rendering, and precise style control. You can use either plain natural language or **structured JSON prompts** for fine-grained control over layout, colors, and in-image text.

<Tip>
  <Tabs>
    <Tab title="Portable or self deployed users">
      Make sure your ComfyUI is updated.

      * [Download ComfyUI](https://www.comfy.org/download)
      * [Update Guide](/installation/update_comfyui)

      Workflows in this guide can be found in the [Workflow Templates](/interface/features/template).
      If you can't find them in the template, your ComfyUI may be outdated. (Desktop version's update will delay sometime)

      If nodes are missing when loading a workflow, possible reasons:

      1. You are not using the latest ComfyUI version (Nightly version)
      2. Some nodes failed to import at startup
    </Tab>

    <Tab title="Desktop or Cloud users">
      * The Desktop is base on ComfyUI stable release, it will auto-update when there is a new Desktop stable release available.
      * [Cloud](https://cloud.comfy.org) will update after ComfyUI stable release.

      So, if you find any core node missing in this document, it might be because the new core nodes have not yet been released in the latest stable version. Please wait for the next stable release.
    </Tab>
  </Tabs>
</Tip>

## Ideogram 4.0 Text-to-Image Workflow

<Card title="Run in Comfy Cloud" icon="cloud" href="https://cloud.comfy.org/?template=image_ideogram4_t2i&utm_source=docs&utm_medium=referral&utm_campaign=ideogram-v4">
  Open in Comfy Cloud
</Card>

<Card title="Download Workflow" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/image_ideogram4_t2i.json">
  Download JSON or search "Ideogram v4: Text to Image" in Template Library
</Card>

![Ideogram 4.0 Example Output](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_ideogram4_t2i.png)
*Example output from the Ideogram 4.0 model*

### Prompt Format

The open-source workflow supports two prompt modes:

1. **Natural language** — Quick and easy, best for simple ideas
2. **Structured JSON** — For precise control over layout, colors, and style

The workflow includes a prompt construction template that you can use with any LLM to generate matching JSON prompts.

A note inside the workflow explains:

> The model is trained on structured JSON captions (scene summary, style block, background, and optional per-object descriptions with bounding boxes and hex color palettes). Official inference validates prompts against that schema.

### Ideogram 4.0 model downloads

You can find all repackaged model files at [Comfy-Org/Ideogram-4](https://huggingface.co/Comfy-Org/Ideogram-4) on Hugging Face.

<Card title="ideogram4_fp8_scaled.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/Ideogram-4/resolve/main/diffusion_models/ideogram4_fp8_scaled.safetensors">
  Diffusion model for Ideogram 4.0 (\~13.8 GB). Place in <code>models/diffusion\_models/</code>
</Card>

<Card title="ideogram4_unconditional_fp8_scaled.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/Ideogram-4/resolve/main/diffusion_models/ideogram4_unconditional_fp8_scaled.safetensors">
  Unconditional diffusion model for Ideogram 4.0 (\~13.8 GB). Place in <code>models/diffusion\_models/</code>
</Card>

<Card title="qwen3vl_8b_fp8_scaled.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/Qwen3-VL/resolve/main/text_encoders/qwen3vl_8b_fp8_scaled.safetensors">
  Text encoder for Ideogram 4.0 (\~8 GB). Place in <code>models/text\_encoders/</code>
</Card>

<Card title="gemma4_e4b_it_fp8_scaled.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/gemma-4/resolve/main/text_encoders/gemma4_e4b_it_fp8_scaled.safetensors">
  Text encoder for Ideogram 4.0 (\~2 GB). Place in <code>models/text\_encoders/</code>
</Card>

<Card title="flux2-vae.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/flux2-dev/resolve/main/split_files/vae/flux2-vae.safetensors">
  VAE for Ideogram 4.0 (\~335 MB). Place in <code>models/vae/</code>
</Card>

**Model storage location**

```
📂 ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │   ├── ideogram4_fp8_scaled.safetensors
│   │   └── ideogram4_unconditional_fp8_scaled.safetensors
│   ├── 📂 text_encoders/
│   │   ├── qwen3vl_8b_fp8_scaled.safetensors
│   │   └── gemma4_e4b_it_fp8_scaled.safetensors
│   └── 📂 vae/
│       └── flux2-vae.safetensors
```

<CardGroup cols={2}>
  <Card title="Learn about Subgraph" icon="book-open" href="/interface/features/subgraph">
    This workflow uses Subgraph nodes for modular processing. Check the Subgraph documentation to learn how to customize and extend.
  </Card>
</CardGroup>

### Workflow Steps

1. Download and place the models in the correct directories (see table above)
2. Download and drag the workflow file into ComfyUI
3. Enter your prompt (natural language or structured JSON) in the Ideogram4 subgraph node
4. (Optional) Adjust resolution using the `ResolutionSelector` node
5. Click `Run` or use shortcut `Ctrl(cmd) + Enter` to generate the image
6. View the result in the `Save Image` node — output files are saved to `ComfyUI/output/`

### Note on Safety Filter

If you see "Image blocked by safety filter", this is Ideogram 4.0's built-in safety filter. Non-JSON (plain-text) prompts have a higher false-positive rate. Using structured JSON prompts reduces the chance of your prompt being blocked.

For more details, see [Ideogram 4's official prompting guide](https://github.com/ideogram-oss/ideogram4/blob/main/docs/prompting.md#safety-filter).

## Live Conversation with Ideogram & ComfyOrg

A special live conversation with Mohammad Norouzi (CEO, Ideogram) and Yoland Yan (CEO, ComfyOrg), hosted by Purz & Rob.

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/gO-D5eO8VlA?si=ehD_qzll3yCzirpP" title="Ideogram 4.0 Live Conversation" allow="accelerometer; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />