> ## 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 节点教程

> 了解如何在 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)

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

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

      1. 你用的不是最新开发版（nightly）。
      2. 你用的是稳定版或桌面版（没有包含最新的更新）。
      3. 启动时有些节点导入失败。
    </Tab>

    <Tab title="桌面版或云端用户">
      * 桌面版是基于 ComfyUI 稳定版本构建的，它会在有新的桌面稳定版本发布时自动更新。
      * [Cloud](https://cloud.comfy.org) 会在 ComfyUI 稳定版本发布后更新，我们会同步更新 Cloud。

      所以，如果你发现本教程中有任何核心节点缺失，那是因为对应的节点支持还在开发中没有发布正式的稳定版，请等待下一个稳定版本发布。
    </Tab>
  </Tabs>
</Tip>

## Ideogram 4.0 文生图工作流

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

![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。
* **模型辅助构建 prompt** — 可以尝试使用 **Ideogram 4 Prompt Builder**（KJNodes）在 ComfyUI 中实现对 prompt 构建的视觉控制。

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