> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-recommend-assets-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# IdeogramV3 - ComfyUI 組み込みノードのドキュメント

> ComfyUI における IdeogramV3 ノードの完全なドキュメントです。入力、出力、パラメーターおよび使用方法について学びましょう。

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

Ideogram V3 ノードは、Ideogram V3 モデルを用いて画像を生成します。テキストプロンプトからの通常の画像生成に加え、画像とマスクの両方が提供された場合の画像編集もサポートしています。このノードでは、アスペクト比、解像度、生成速度、およびオプションのキャラクター参照画像を制御するためのさまざまな設定が利用可能です。

## 入力

| パラメーター                | データ型   | 必須  | 範囲                                                                                                                                                      | 説明                                                                       |
| --------------------- | ------ | --- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| `prompt`              | STRING | はい  | -                                                                                                                                                       | 画像生成または編集用のプロンプト（デフォルト：空）                                                |
| `image`               | IMAGE  | いいえ | -                                                                                                                                                       | 画像編集用のオプションの参照画像                                                         |
| `mask`                | MASK   | いいえ | -                                                                                                                                                       | インペインティング用のオプションのマスク（白い領域が置き換えられます）                                      |
| `aspect_ratio`        | COMBO  | いいえ | "1:1"<br />"16:9"<br />"9:16"<br />"4:3"<br />"3:4"<br />"3:2"<br />"2:3"                                                                               | 画像生成時のアスペクト比。解像度が「Auto」に設定されていない場合は無視されます（デフォルト："1:1"）                   |
| `resolution`          | COMBO  | いいえ | "Auto"<br />"1024x1024"<br />"1152x896"<br />"896x1152"<br />"1216x832"<br />"832x1216"<br />"1344x768"<br />"768x1344"<br />"1536x640"<br />"640x1536" | 画像生成時の解像度。「Auto」に設定されていない場合、この値が `aspect_ratio` の設定を上書きします（デフォルト："Auto"） |
| `magic_prompt_option` | COMBO  | いいえ | "AUTO"<br />"ON"<br />"OFF"                                                                                                                             | 生成時に MagicPrompt を使用するかどうかを指定します（デフォルト："AUTO"）                           |
| `seed`                | INT    | いいえ | 0–2147483647                                                                                                                                            | 生成時の乱数シード（デフォルト：0）                                                       |
| `num_images`          | INT    | いいえ | 1–8                                                                                                                                                     | 生成する画像の枚数（デフォルト：1）                                                       |
| `rendering_speed`     | COMBO  | いいえ | "DEFAULT"<br />"TURBO"<br />"QUALITY"                                                                                                                   | 生成速度と画質のトレードオフを制御します（デフォルト："DEFAULT"）                                    |
| `character_image`     | IMAGE  | いいえ | -                                                                                                                                                       | キャラクター参照として使用する画像                                                        |
| `character_mask`      | MASK   | いいえ | -                                                                                                                                                       | キャラクター参照画像用のオプションのマスク                                                    |

**パラメーター制約：**

* `image` と `mask` の両方が提供された場合、ノードは編集モードに切り替わります
* `image` または `mask` のいずれか一方のみが提供された場合、エラーが発生します
* `character_mask` を使用するには、`character_image` も必ず指定する必要があります
* `resolution` が「Auto」に設定されていない場合、`aspect_ratio` パラメーターは無視されます
* インペインティング時、マスク内の白い領域が置き換えられます
* キャラクターマスクとキャラクター画像は、サイズが一致している必要があります

## 出力

| 出力名      | データ型  | 説明           |
| -------- | ----- | ------------ |
| `output` | IMAGE | 生成または編集された画像 |