> ## 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.
# IdeogramTextToImageApi - ComfyUI Built-in Node Documentation
> 使用 Ideogram 4.5 根据文本提示词生成图像。
使用 Ideogram 4.5 根据文本提示词生成图像。提示词也可以接受 Ideogram 结构化 JSON 描述（caption），例如先前某次运行返回的 `final_prompt`，它可精确控制文本字符串、颜色和布局。此节点返回生成的图像，以及图像实际生成时所依据的描述。
## 输入
| 参数 | 描述 | 数据类型 | 必填 | 取值范围 |
| - | - | - | - | - |
| `模型` | 要使用的模型。（默认值：`"ideogram-4.5"`） | DYNAMIC\_COMBO | 是 | `"ideogram-4.5"` |
| `prompt` | 文本提示词，或 Ideogram 结构化 JSON 描述，例如之前的 `final_prompt`。（默认值：空字符串） | STRING | 是 | 1 到 10000 个字符 |
| `size` | 输出尺寸。`"auto"` 让模型选择适合该提示词的画布。`(2K)` 或 `(1K)` 预设会同时固定像素尺寸和宽高比。（默认值：`"auto"`） | COMBO | 是 | `"auto"`
`"(2K) 2048x2048 (1:1)"`
`"(2K) 1440x2880 (1:2)"`
`"(2K) 2880x1440 (2:1)"`
`"(2K) 1664x2496 (2:3)"`
`"(2K) 2496x1664 (3:2)"`
`"(2K) 1792x2240 (4:5)"`
`"(2K) 2240x1792 (5:4)"`
`"(2K) 1440x2560 (9:16)"`
`"(2K) 2560x1440 (16:9)"`
`"(2K) 1600x2560 (5:8)"`
`"(2K) 2560x1600 (8:5)"`
`"(2K) 1728x2304 (3:4)"`
`"(2K) 2304x1728 (4:3)"`
`"(2K) 1296x3168 (9:22)"`
`"(2K) 3168x1296 (22:9)"`
`"(2K) 1152x2944 (9:23)"`
`"(2K) 2944x1152 (23:9)"`
`"(2K) 1248x3328 (3:8)"`
`"(2K) 3328x1248 (8:3)"`
`"(2K) 1280x3072 (5:12)"`
`"(2K) 3072x1280 (12:5)"`
`"(2K) 1024x3072 (1:3)"`
`"(2K) 3072x1024 (3:1)"`
`"(1K) 1024x1024 (1:1)"`
`"(1K) 896x1120 (4:5)"`
`"(1K) 1120x896 (5:4)"`
`"(1K) 864x1152 (3:4)"`
`"(1K) 1152x864 (4:3)"`
`"(1K) 832x1248 (2:3)"`
`"(1K) 1248x832 (3:2)"`
`"(1K) 800x1280 (5:8)"`
`"(1K) 1280x800 (8:5)"`
`"(1K) 720x1280 (9:16)"`
`"(1K) 1280x720 (16:9)"`
`"(1K) 720x1440 (1:2)"`
`"(1K) 1440x720 (2:1)"` |
| `quality` | 质量档位。档位越高，成本越高、耗时越长。（默认值：`"medium"`） | COMBO | 是 | `"low"`
`"medium"`
`"high"` |
| `magic_prompt` | 在生成之前将提示词重写为详细的结构化描述；`"off"` 会尽可能保留你的原始表述。该描述会作为 `final_prompt` 返回。（默认值：`"auto"`）这是高级设置。 | COMBO | 是 | `"auto"`
`"on"`
`"off"` |
| `seed` | 生成所用的种子。由于每次运行都会重写提示词，文生图仅凭种子无法复现；要复现某张图像，请复用其 `final_prompt`，将 `magic_prompt` 设为 `"off"`，并使用相同的种子。（默认值：42） | INT | 是 | 0 到 2147483647 |
### 参数约束
* **提示词必填：** 提示词必须至少包含一个非空白字符，且最多 10000 个字符。在提供自己的 JSON 描述或精确表述时，请将 `magic_prompt` 设为 `"off"`。
* **尺寸：** `"auto"` 让模型自行选择。`(2K)` 预设约为 3 至 4 百万像素，`(1K)` 预设约为 1 百万像素，因此档位标签描述的是像素总量而非固定长边；预设的宽高比会被遵循。只有预设中的像素尺寸部分会发送给 API。
* **可复现性：** 当 `magic_prompt` 设为 `"auto"` 或 `"on"` 时，提示词会在每次运行时被重写，因此相同的种子仍可能生成不同的图像。要复现某张图像，请将其 `final_prompt` 回传，将 `magic_prompt` 设为 `"off"`，并使用相同的种子。
* **内容安全：** 如果 Ideogram 的内容安全过滤器拦截了生成，节点会抛出错误，而不是返回图像。
## 输出
| 输出名称 | 描述 | 数据类型 |
| - | - | - |
| `IMAGE` | 生成的图像（以批次形式）。 | IMAGE |
| `final_prompt` | 图像生成时所依据的结构化描述。将其回传，并将 `magic_prompt` 设为 `"off"`，再使用相同的种子，即可复现该图像。 | STRING |
> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/IdeogramTextToImageApi/zh.md)
***
**Source fingerprint (SHA-256):** `a21f1faed9ca7a7bc63dae74003cc7599f11013075f718af9e5860d2cd666828`
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.