# Ideogram 4.5 Text to Image

使用 Ideogram 4.5 從文字提示生成影像。提示也接受 Ideogram 結構化 JSON 標題，例如先前執行回傳的 `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"`<br>`"(2K) 2048x2048 (1:1)"`<br>`"(2K) 1440x2880 (1:2)"`<br>`"(2K) 2880x1440 (2:1)"`<br>`"(2K) 1664x2496 (2:3)"`<br>`"(2K) 2496x1664 (3:2)"`<br>`"(2K) 1792x2240 (4:5)"`<br>`"(2K) 2240x1792 (5:4)"`<br>`"(2K) 1440x2560 (9:16)"`<br>`"(2K) 2560x1440 (16:9)"`<br>`"(2K) 1600x2560 (5:8)"`<br>`"(2K) 2560x1600 (8:5)"`<br>`"(2K) 1728x2304 (3:4)"`<br>`"(2K) 2304x1728 (4:3)"`<br>`"(2K) 1296x3168 (9:22)"`<br>`"(2K) 3168x1296 (22:9)"`<br>`"(2K) 1152x2944 (9:23)"`<br>`"(2K) 2944x1152 (23:9)"`<br>`"(2K) 1248x3328 (3:8)"`<br>`"(2K) 3328x1248 (8:3)"`<br>`"(2K) 1280x3072 (5:12)"`<br>`"(2K) 3072x1280 (12:5)"`<br>`"(2K) 1024x3072 (1:3)"`<br>`"(2K) 3072x1024 (3:1)"`<br>`"(1K) 1024x1024 (1:1)"`<br>`"(1K) 896x1120 (4:5)"`<br>`"(1K) 1120x896 (5:4)"`<br>`"(1K) 864x1152 (3:4)"`<br>`"(1K) 1152x864 (4:3)"`<br>`"(1K) 832x1248 (2:3)"`<br>`"(1K) 1248x832 (3:2)"`<br>`"(1K) 800x1280 (5:8)"`<br>`"(1K) 1280x800 (8:5)"`<br>`"(1K) 720x1280 (9:16)"`<br>`"(1K) 1280x720 (16:9)"`<br>`"(1K) 720x1440 (1:2)"`<br>`"(1K) 1440x720 (2:1)"` |
| `quality` | 品質等級。較高等級成本更高且耗時更長。（預設值：`"medium"`） | COMBO | 是 | `"low"`<br>`"medium"`<br>`"high"` |
| `magic_prompt` | 在生成前將提示改寫為詳細的結構化標題；`"off"` 會盡可能保留你的原文措辭。該標題會以 `final_prompt` 回傳。（預設值：`"auto"`）這是進階設定。 | COMBO | 是 | `"auto"`<br>`"on"`<br>`"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-TW.md)

---
**Source fingerprint (SHA-256):** `a21f1faed9ca7a7bc63dae74003cc7599f11013075f718af9e5860d2cd666828`
