> ## 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.

# IdeogramPImage - ComfyUI Built-in Node Documentation

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

Ideogram P-Image は、Ideogram の高速テキスト画像変換モデルを使用して、テキストプロンプトから画像を生成します。このモデルは、優れたタイポグラフィとフォトリアリズムで知られています。また、Ideogram 4.0 の構造化 JSON キャプションにも対応しており、テキスト文字列、色、レイアウトを正確に制御できます。このノードは、生成された画像と、画像が実際に生成された元の最終プロンプトを返します。

## 入力

| パラメータ               | 説明                                                                                                                                                                                         | データ型   | 必須  | 範囲                                                                                                                                                                    |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | --- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `prompt`            | テキストプロンプト。Ideogram 4.0 の構造化 JSON キャプション（#RRGGBB 形式の正確な色、正確なテキスト文字列、バウンディングボックスレイアウト）も受け入れます。そのまま使用するには、`prompt_upsampling` を OFF に設定してください。空にすることはできません。（デフォルト: ""）                        | STRING | はい  | 任意のテキスト                                                                                                                                                               |
| `quality`           | 速度/コスト/品質の階層です。MEDIUM は日常的なデフォルトです。HIGH は複雑なプロンプト、微細なディテール、難しいテキスト向けです。VERY\_LOW/LOW は大規模な下書き用です。難しいテキストは MEDIUM 未満では描画品質が低下します。（デフォルト: "MEDIUM"）                                          | STRING | はい  | "VERY\_LOW"<br />"LOW"<br />"MEDIUM"<br />"HIGH"                                                                                                                      |
| `resolution`        | 出力サイズのクラスです（正確なピクセル数はアスペクト比に応じて決まります。例: 16:9 の場合、1K では 1280x720、2K では 2560x1440 になります）。鮮明なタイポグラフィが必要な場合は、HIGH + 2K を推奨します。（デフォルト: "1K"）                                                    | STRING | はい  | "1K"<br />"2K"                                                                                                                                                        |
| `aspect_ratio`      | 画像生成時のアスペクト比です。（デフォルト: "1:1"）                                                                                                                                                              | STRING | はい  | "1:3"<br />"3:1"<br />"1:2"<br />"2:1"<br />"9:16"<br />"16:9"<br />"10:16"<br />"16:10"<br />"2:3"<br />"3:2"<br />"3:4"<br />"4:3"<br />"4:5"<br />"5:4"<br />"1:1" |
| `prompt_upsampling` | 生成前に短いプロンプトを詳細な構造化キャプションに展開します（書き換えられたプロンプトは `final_prompt` として返されます）。独自の JSON キャプションや正確な文言を指定する場合は OFF に設定してください。（デフォルト: "AUTO"）                                                          | STRING | はい  | "AUTO"<br />"ON"<br />"OFF"                                                                                                                                           |
| `seed`              | 再現可能な生成のためのシードです。`prompt_upsampling` が OFF の場合、同じシードと設定で同じ画像が返されます。ON/AUTO の場合、プロンプトの書き換えは実行ごとに変化します。結果を再現するには、その `final_prompt` 出力を `prompt_upsampling` OFF かつ同じシードで再利用してください。（デフォルト: 42） | INT    | いいえ | 0 から 2147483647                                                                                                                                                       |

**制約に関する注意:** プロンプトには空白以外の文字が少なくとも 1 文字含まれている必要があります。含まれていない場合、ノードは失敗します。独自の構造化 JSON キャプションや正確な文言を指定する場合は、`prompt_upsampling` を OFF に設定してください。`prompt_upsampling` が ON または AUTO の場合、生成前にプロンプトが書き換えられるため、同じシードでも同じ画像が再現されないことがあります。画像を再現するには、その `final_prompt` 出力を `prompt_upsampling` OFF かつ同じシードで再利用してください。

## 出力

| 出力名            | 説明                                                                                                                                                      | データ型   |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| `image`        | 生成された画像です。画像のバッチとして返されます。Ideogram のコンテンツセーフティフィルターが生成をブロックした場合は、代わりにエラーが発生します。                                                                          | IMAGE  |
| `final_prompt` | 画像が実際に生成された元のプロンプトです（`prompt_upsampling` が実行された場合は書き換え後の構造化キャプション、それ以外の場合は指定したプロンプト）。この画像を再現するには、`prompt_upsampling` を OFF にし、同じシードでこのプロンプトを再度入力してください。 | STRING |

> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください！ [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/IdeogramPImage/ja.md)

***

**Source fingerprint (SHA-256):** `7bd20aae508fee111ded32e87119ed6fc01c5ad5ba7d595e24391830a0f20bb7`