> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-willie-des-1087-router-migration-block.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 提示词**，对布局、颜色以及图像内的文字进行精细控制。

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

## 使用它

<Card title="从代码中调用" icon="code" href="/zh/development/comfy-router/models/ideogram/ideogram-v4/code">
  通过 Comfy Router 以 HTTP 方式调用，附带可直接复制粘贴的 Python、TypeScript 和 cURL 代码片段
</Card>

它与在下方 ComfyUI 中运行共用同一个 Comfy 账户，并按相同的积分计费。各模型的费率请参见[合作伙伴节点积分](/zh/tutorials/partner-nodes/pricing)，可同时进行的请求数量请参见[并发限制](/zh/tutorials/partner-nodes/concurrency-limits)。

<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 的示例输出*

### 提示词格式

Ideogram V4 节点支持两种提示词格式：

1. **自然语言**：简单直观，最适合快速表达想法。
2. **结构化 JSON**：可对风格色彩主题、元素位置（`bbox`）以及图像中的文字渲染进行精细控制。推荐用于海报式构图。

默认工作流示例使用结构化 JSON 提示词，其中包含：

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

### 工作流步骤

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

### 使用 JSON 提示词构建器（可选）

该工作流内置了一个 **Gemini** 节点（Gemini 3.1 Pro），可帮助你构建结构化 JSON 提示词：

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

## 附加说明

* **不需要负面提示词**：Ideogram 4.0 模型使用非对称无分类器引导（asymmetric classifier-free guidance），其无条件分支会丢弃文本 token，因此无需单独的负面提示词字符串。
* **模型辅助的提示词构建**：在 ComfyUI 上，可以考虑使用 **Ideogram 4 Prompt Builder**（KJNodes），以可视化方式控制提示词的构建。