> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec-2b9c2cf.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ComfyUI Ideogram 4.0 开源模型教程

> 了解如何在 ComfyUI 中使用 Ideogram 4.0 开源模型

Ideogram 4.0 是 Ideogram 最新的文生图模型，以开源模型的形式发布，可完全在你自己的硬件上运行。它提供卓越的照片级真实感质量、准确的文本渲染和精准的风格控制。你可以使用普通的自然语言，或使用**结构化 JSON 提示词**来精细控制布局、颜色和图中文字。

<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 文生图工作流

<h3 id="image_ideogram4_t2i">
  Ideogram v4：文生图
</h3>

输入文本提示词或结构化 JSON 描述。使用 Ideogram 4.0 生成具有精准布局、颜色和风格控制的图像。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/image_ideogram4_t2i-1.webp" alt="Ideogram 4.0 text-to-image workflow preview" />

<CardGroup cols={2}>
  <Card title="在 Comfy Cloud 上运行" icon="cloud" href="https://cloud.comfy.org/?template=image_ideogram4_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/image_ideogram4_t2i.json">
    下载 JSON 或在模板库中搜索"Ideogram v4: Text to Image"
  </Card>
</CardGroup>

**示例输出**

![Ideogram 4.0 example output](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_ideogram4_t2i.png)

### 提示词格式

开源工作流支持两种提示词模式：

1. **自然语言**：快速简便，最适合简单的创意
2. **结构化 JSON**：用于精确控制布局、颜色和风格

工作流中包含一个提示词构建模板，你可以配合任意 LLM 使用它来生成匹配的 JSON 提示词。

工作流内的注释解释道：

> 该模型使用结构化 JSON 描述（场景摘要、风格块、背景，以及可选的带边界框和十六进制调色板的逐对象描述）进行训练。官方推理会针对该 schema 验证提示词。

### Ideogram 4.0 模型下载

你可以在 Hugging Face 的 [Comfy-Org/Ideogram-4](https://huggingface.co/Comfy-Org/Ideogram-4) 找到所有重新打包的模型文件。

<CardGroup cols={2}>
  <Card title="ideogram4_fp8_scaled.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/Ideogram-4/blob/main/diffusion_models/ideogram4_fp8_scaled.safetensors">
    Ideogram 4.0 的 diffusion 模型（约 13.8 GB）。放入 <code>models/diffusion\_models/</code>
  </Card>

  <Card title="ideogram4_unconditional_fp8_scaled.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/Ideogram-4/blob/main/diffusion_models/ideogram4_unconditional_fp8_scaled.safetensors">
    Ideogram 4.0 的无条件 diffusion 模型（约 13.8 GB）。放入 <code>models/diffusion\_models/</code>
  </Card>

  <Card title="qwen3vl_8b_fp8_scaled.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/Qwen3-VL/blob/main/text_encoders/qwen3vl_8b_fp8_scaled.safetensors">
    Ideogram 4.0 的文本编码器（约 8 GB）。放入 <code>models/text\_encoders/</code>
  </Card>

  <Card title="gemma4_e4b_it_fp8_scaled.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/gemma-4/blob/main/text_encoders/gemma4_e4b_it_fp8_scaled.safetensors">
    Ideogram 4.0 的文本编码器（约 2 GB）。放入 <code>models/text\_encoders/</code>
  </Card>

  <Card title="flux2-vae.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/flux2-dev/blob/main/split_files/vae/flux2-vae.safetensors">
    Ideogram 4.0 的 VAE（约 335 MB）。放入 <code>models/vae/</code>
  </Card>
</CardGroup>

**模型保存位置**

```
📂 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="了解子图" icon="book-open" href="/zh/interface/features/subgraph">
    此工作流使用子图节点进行模块化处理。查看子图文档，了解如何自定义和扩展。
  </Card>
</CardGroup>

### 工作流步骤

1. 下载模型并放入正确的目录（见上表）
2. 下载工作流文件并拖入 ComfyUI
3. 在 Ideogram4 子图节点中输入你的提示词（自然语言或结构化 JSON）
4. （可选）使用 `ResolutionSelector` 节点调整分辨率
5. 点击 `Run` 或使用快捷键 `Ctrl(cmd) + Enter` 生成图像
6. 在 `Save Image` 节点中查看结果，输出文件保存在 `ComfyUI/output/`

### 关于安全过滤器的说明

如果你看到 "Image blocked by safety filter"，这是 Ideogram 4.0 的内置安全过滤器。非 JSON（纯文本）提示词的误报率更高。使用结构化 JSON 提示词可以降低提示词被拦截的概率。

更多详情请参阅 [Ideogram 4 官方提示词指南](https://github.com/ideogram-oss/ideogram4/blob/main/docs/prompting.md#safety-filter)。

## 与 Ideogram & ComfyOrg 的直播对话

由 Purz & Rob 主持，与 Mohammad Norouzi（Ideogram CEO）和 Yoland Yan（ComfyOrg CEO）的特别直播对话。

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