> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# BuildJsonPromptIdeogram - ComfyUI Built-in Node Documentation

> Complete documentation for the BuildJsonPromptIdeogram node in ComfyUI. Learn its inputs, outputs, parameters and usage.

此节点构建一个结构化的 JSON 提示词，专为 Ideogram 4 图像生成模型格式化。它将您的文本指令、风格偏好和调色板组织成模型所需的 JSON 结构。

## 输入

| 参数          | 描述                                                                    | 数据类型   | 是否必填 | 范围                                         |
| ----------- | --------------------------------------------------------------------- | ------ | ---- | ------------------------------------------ |
| `元素`        | 来自“创建边界框”节点的提示词元素。                                                    | ARRAY  | 是    | -                                          |
| `高级描述`      | 可选的一两句图像描述。强烈建议填写。（默认：空）                                              | STRING | 否    | -                                          |
| `背景`        | 图像背景或环境的必填描述。（默认：空）                                                   | STRING | 是    | -                                          |
| `风格`        | 生成图像的视觉风格类别。（默认："none"）                                               | COMBO  | 是    | `"none"`<br />`"photo"`<br />`"art_style"` |
| `photo`     | 摄影输出的相机或镜头细节（例如 35mm、f/1.4、散景）。仅在 `风格` 设置为 "photo" 时可用。（默认：空）         | STRING | 否    | -                                          |
| `art_style` | 艺术风格描述（例如扁平矢量插画、粗轮廓线）。仅在 `风格` 设置为 "art\_style" 时可用。（默认：空）             | STRING | 否    | -                                          |
| `美学`        | 必填的美学关键词（例如情绪化、电影感、去饱和）。（默认：空）                                        | STRING | 是    | -                                          |
| `光照`        | 必填的照明描述（例如黄金时刻、轮廓光、戏剧性阴影）。（默认：空）                                      | STRING | 是    | -                                          |
| `媒介`        | 必填的媒介类型（例如照片、插画、3D 渲染、绘画、平面设计）。当 `风格` = photo 时，设置为 photograph。（默认：空） | STRING | 是    | -                                          |
| `色板`        | 十六进制颜色代码，用于引导图像的主色调。最多 16 个条目。                                        | COLORS | 否    | -                                          |

**注意：** 当 `style` 参数设置为 "photo" 时，`photo` 输入变为可用，并且您应将 `medium` 参数设置为 "photograph"。当 `style` 设置为 "art\_style" 时，`art_style` 输入变为可用。

## 输出

| 输出名称 | 描述                                              | 数据类型 |
| ---- | ----------------------------------------------- | ---- |
| `提示` | 一个结构化的 JSON 字典，包含高级描述、风格描述（如适用），以及包含背景和元素的构图解构。 | DICT |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BuildJsonPromptIdeogram/zh.md)

***

**Source fingerprint (SHA-256):** `56a045e0c7c19531e6443696c0bdf3946df066d03eea7d2d217b7d92f052592f`