> ## 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 キャプションも指定できます。たとえば、以前の実行で返された `final_prompt` などです。これにより、テキスト文字列、色、レイアウトを正確に制御できます。ノードは、生成された画像と、その画像が実際に生成された元のキャプションを返します。
## 入力
| パラメータ | 説明 | データ型 | 必須 | 範囲 |
| - | - | - | - | - |
| `モデル` | 使用するモデル。(デフォルト: `"ideogram-4.5"`) | DYNAMIC\_COMBO | はい | `"ideogram-4.5"` |
| `prompt` | テキストプロンプト、または以前の `final_prompt` のような Ideogram 構造化 JSON キャプション。(デフォルト: 空文字列) | 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 |
### パラメータ制約
* **プロンプト必須:** プロンプトには少なくとも1つの空白以外の文字を含める必要があり、最大10000文字までです。独自の JSON キャプションや正確な表現を指定する場合は、`magic_prompt` を `"off"` に設定してください。
* **サイズ:** `"auto"` はモデルに選択させます。`(2K)` プリセットは約300万〜400万画素、`(1K)` プリセットは約100万画素です。階層ラベルは固定の長辺ではなく画素数の目安を表します。プリセットのアスペクト比が尊重されます。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/ja.md)
***
**Source fingerprint (SHA-256):** `a21f1faed9ca7a7bc63dae74003cc7599f11013075f718af9e5860d2cd666828`
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.