> ## 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 Partner Node Tutorial

> Learn how to use the Ideogram 4.0 API Partner node in ComfyUI

Ideogram 4.0 is the latest text-to-image model from Ideogram, offering 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>
  To use the Partner Nodes, you need to ensure that you are logged in properly and using a permitted network environment. Please refer to the [Partner Nodes Overview](/tutorials/partner-nodes/overview) section of the documentation to understand the specific requirements for using the Partner Nodes.
</Tip>

<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 Partner Node Text-to-Image Workflow

<Card title="Run in Comfy Cloud" icon="cloud" href="https://cloud.comfy.org/?template=api_ideogram_v4_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/api_ideogram_v4_t2i.json">
  Download JSON or search "Ideogram v4: Text to Image (API)" in Template Library
</Card>

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

### Prompt Format

The Ideogram V4 node supports two prompt formats:

1. **Natural Language** — Simple and intuitive, best for quick ideas.
2. **Structured JSON** — Offers fine-grained control over style palette, element placement (`bbox`), and literal text rendering in the image. Recommended for poster-like compositions.

The default workflow example uses a structured JSON prompt that includes:

* `high_level_description` — Overall scene description
* `style_description` — Aesthetic, lighting, medium, color palette
* `compositional_deconstruction` — Per-element bounding boxes, descriptions, and color palettes

### Workflow Steps

1. Download and drag the workflow file into ComfyUI
2. The `Ideogram V4` node already contains a default structured JSON prompt — you can modify it or write plain natural language
3. Click `Run` or use shortcut `Ctrl(cmd) + Enter` to generate the image
4. After the API returns results, view the generated image in the `Save Image` node. Images are saved to the `ComfyUI/output/` directory

### Using the JSON Prompt Builder (Optional)

The workflow includes a built-in **Gemini** node (Gemini 3.1 Pro) to help you build structured JSON prompts:

1. Describe your idea in the Gemini node's user prompt field
2. The model will generate a schema-matching JSON prompt
3. Connect the `STRING` output to the `Ideogram V4` node's `prompt` input
4. Run the workflow

## Additional Notes

* **Negative prompts are not needed** — The Ideogram 4.0 model uses asymmetric classifier-free guidance, where the unconditional pass drops text tokens, rather than requiring a separate negative prompt string.
* **Model-assisted prompt building** — Consider using the **Ideogram 4 Prompt Builder** (KJNodes) for visual control over prompt construction on ComfyUI.

## 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 />