> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-custom-nodes-sdk-v2-frontend.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ComfyUI Ideogram 4.0 节点教程

> 了解如何在 ComfyUI 中使用 Ideogram 4.0 API Partner Node

Ideogram 4.0 是 Ideogram 最新推出的文生图模型，具有出色的照片级真实感、精准的文字渲染和风格控制能力。你可以使用自然语言或 **结构化 JSON Prompts** 来实现对布局、颜色和图片内文字的精细控制。

<Tip>
  使用 API 节点需要保证你已经正常登录，并在受许可的网络环境下使用，请参考[API 节点总览](/zh/tutorials/partner-nodes/overview)部分文档来了解使用 API 节点的具体使用要求。
</Tip>

<Tip>
  <Tabs>
    <Tab title="本地用户">
      请确保你的 ComfyUI 已经更新。

      * [ComfyUI 下载](https://www.comfy.org/download)
      * [ComfyUI 更新教程](/zh/installation/update_comfyui)

      本指南里的工作流可以在[工作流模板](/zh/interface/features/template)中找到。如果找不到，可能是 ComfyUI 没有更新。

      如果加载工作流时有节点缺失，可能原因有：

      1. 你用的不是最新版（每夜版）。
      2. 启动时有些节点导入失败。
    </Tab>

    <Tab title="云端用户">
      * [Cloud](https://cloud.comfy.org) 会在 ComfyUI 稳定版本发布后更新。

      所以，如果你发现本文档中有任何核心节点缺失，可能是因为新核心节点尚未在最新稳定版中发布。请等待下一个稳定版发布。
    </Tab>
  </Tabs>
</Tip>

## Ideogram 4.0 擅长什么

* **照片级真实感质量**：在已生成的图像中展现出卓越的照片级真实感
* **精准的文字渲染**：可在图像中渲染出文字，非常适合海报式构图
* **精确的风格控制**：结构化 JSON 提示词可控制风格调色板、元素位置（`bbox`）以及各元素的颜色调色板
* **灵活的提示方式**：可使用纯自然语言快速表达想法，也可使用结构化 JSON 进行精细控制
* **无需负面提示词**：使用非对称的无分类器引导，而非单独的负面提示词字符串

## 示例输出

从结构化 JSON 提示进行文生图：

![Ideogram 4.0 示例输出](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/api_ideogram_v4_t2i.png)
*来自 Ideogram 4.0 API 的示例输出*

## Ideogram & ComfyOrg 创始人对谈

一场特别的直播对谈，嘉宾为 Mohammad Norouzi（Ideogram CEO）和 Yoland Yan（ComfyOrg CEO），由 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 />

<Tip>
  使用 API 节点需要保证你已经正常登录，并在受许可的网络环境下使用，请参考[API 节点总览](/zh/tutorials/partner-nodes/overview)部分文档来了解使用 API 节点的具体使用要求。
</Tip>

<Tip>
  <Tabs>
    <Tab title="本地用户">
      请确保你的 ComfyUI 已经更新。

      * [ComfyUI 下载](https://www.comfy.org/download)
      * [ComfyUI 更新教程](/zh/installation/update_comfyui)

      本指南里的工作流可以在[工作流模板](/zh/interface/features/template)中找到。如果找不到，可能是 ComfyUI 没有更新。

      如果加载工作流时有节点缺失，可能原因有：

      1. 你用的不是最新版（每夜版）。
      2. 启动时有些节点导入失败。
    </Tab>

    <Tab title="云端用户">
      * [Cloud](https://cloud.comfy.org) 会在 ComfyUI 稳定版本发布后更新。

      所以，如果你发现本文档中有任何核心节点缺失，可能是因为新核心节点尚未在最新稳定版中发布。请等待下一个稳定版发布。
    </Tab>
  </Tabs>
</Tip>

## Ideogram 4.0 合作伙伴节点文生图工作流

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_ideogram_v4_t2i-1.webp" alt="Ideogram 4.0 文生图工作流预览" />

<CardGroup cols={2}>
  <Card title="在 Comfy Cloud 上运行" icon="cloud" href="https://cloud.comfy.org/?template=api_ideogram_v4_t2i&utm_source=docs&utm_medium=referral&utm_campaign=ideogram-v4">
    在 Comfy Cloud 中打开
  </Card>

  <Card title="下载工作流" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_ideogram_v4_t2i.json">
    下载 JSON 或在模板库中搜索"Ideogram v4: Text to Image (API)"
  </Card>
</CardGroup>

![Ideogram 4.0 示例输出](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/api_ideogram_v4_t2i.png)
*来自 Ideogram 4.0 API 的示例输出*

### Prompt 格式

Ideogram V4 节点支持两种 prompt 格式：

1. **自然语言**：简单直观，适合快速构思。
2. **结构化 JSON**：可精细控制色彩主题、元素位置（`bbox`）和图像内的文字渲染，推荐用于海报类构图。

默认工作流示例使用了结构化 JSON prompt，包含：

* `high_level_description`：整体场景描述。
* `style_description`：美学风格、光照、媒介、色彩主题。
* `compositional_deconstruction`：每个元素的边界框、描述和色彩主题。

### 工作流步骤

1. 下载并将工作流文件拖入 ComfyUI。
2. `Ideogram V4` 节点已包含默认的结构化 JSON prompt：你可以修改它，也可以直接写自然语言。
3. 点击 `Run` 或使用快捷键 `Ctrl(cmd) + Enter` 生成图像。
4. API 返回结果后，在 `Save Image` 节点查看已生成的图像。图像会保存到 `ComfyUI/output/` 目录。

### 使用 JSON Prompt Builder（可选）

工作流内置了一个 **Gemini** 节点（Gemini 3.1 Pro）帮助你构建结构化 JSON prompt：

1. 在 Gemini 节点的用户输入字段中描述你的想法。
2. 模型会生成符合 schema 的 JSON prompt。
3. 将 `STRING` 输出连接到 `Ideogram V4` 节点的 `prompt` 输入。
4. 运行工作流。

## 补充说明

* **不需要负面提示词**：Ideogram 4.0 模型使用非对称无分类器引导（asymmetric CFG），无条件路径会丢弃文本 token，而不是需要单独的负面提示词字符串。
* **模型辅助构建 prompt**：可以考虑使用 **Ideogram 4 Prompt Builder**（KJNodes）在 ComfyUI 中实现对 prompt 构建的视觉控制。