这个 ComfyUI 教程工作流演示如何使用 Ideogram 4.0 生成图像：既支持简单文本提示词，也支持结构化 JSON caption，以实现精确的视觉控制。Ideogram4 Caption Prompt Template 子图会引导你描述场景摘要、风格块、背景，以及可选的逐对象元素（包含边界框与十六进制调色板）。ResolutionSelector 节点统一宽度与高度；MarkdownNote 解释 JSON schema，帮助你编写具备布局意识的提示词而无需猜测。PreviewAny 提供实时反馈，SaveImage 将最终输出写入磁盘。
在底层，工作流会将你的提示词路由到自定义的 Ideogram v4 推理节点，该节点由 ideogram4_fp8_scaled 扩散模型和兼容的 VAE（flux2-vae）支持。如果你提供纯文本，模板会为其包装合理的默认值；如果你提供结构化 JSON，则会直接透传，使模型能够遵循布局、颜色与风格约束。该设置对齐 Ideogram 4.0 的官方 caption schema（该模型训练时使用的格式），让你在本地获得可复现的构图与颜色控制。对于更偏好可视化编辑器的用户，你还可以选择性添加 KJNodes 和 Ideogram 4 Prompt Builder KJ 节点，以交互方式创建边界框与调色板。
API
通过代码使用此工作流
每个 Comfy 工作流都是一个 JSON 图。下面的内容就是此工作流的完整数据，ComfyUI 运行时也是如此——你可以从该 URL 获取、放入版本控制，或在 ComfyUI 中加载并逐节点运行。
使用 Comfy SDK 从 TypeScript 或 Python 运行。相同代码可用于 Comfy Cloud 或你自托管的 ComfyUI——只需更改基础 URL。
// Install (beta)
npm i @comfyorg/sdk
// Run this workflow (TypeScript)
import { Comfy } from "@comfyorg/sdk";
const client = new Comfy({ apiKey: "comfyui-..." });
const wf = await client.workflows.fromFile("workflow_api.json");
const job = await client.run(wf);
await job.getOutputs("<output-node-id>")[0].toFile("output.png");SDK 需要 API 格式的工作流：在 ComfyUI 中打开此工作流，使用 文件 → 导出工作流（API）。
常见问题
