Azure OpenAI イメージ生成モデルを使用する方法

2025-06-24

OpenAI のイメージ生成モデルでは、ユーザーが指定したテキストプロンプトと必要に応じて提供される画像に基づいてイメージがレンダリングされます。このガイドでは、イメージ生成モデルを使用し、REST API 呼び出しを使用してそのオプションを構成する方法を示します。

前提条件

Azure サブスクリプション。無料で作成できます。
サポートされるリージョンに作成された Azure OpenAI リソース。利用可能なリージョンに関するページを参照してください。
Azure OpenAI リソースを使用して dall-e-3 または gpt-image-1 モデルをデプロイします。デプロイの詳細については、「 Azure OpenAI を使用してリソースを作成し、モデルをデプロイする」を参照してください。
- GPT-image-1 は新しいモデルであり、DALL-E 3 より多くの機能強化が特徴です。制限付きアクセスで利用できます。このフォームでアクセスを申請してください。

イメージ生成 API を呼び出す

次のコマンドは、コードでイメージモデルを使用する最も基本的な方法を示しています。これらのモデルをプログラムで初めて使用する場合は、クイックスタートから開始することをお勧めします。

GPT-image-1
DALL-E 3

POST 要求を次の宛先に送信します。

https://<your_resource_name>.openai.azure.com/openai/deployments/<your_deployment_name>/images/generations?api-version=<api_version>

URL:

次の値を置き換えます。

<your_resource_name> は、Azure OpenAI リソースの名前です。
<your_deployment_name> は、DALL-E 3 または GPT-image-1 モデルデプロイの名前です。
<api_version> は、使う API のバージョンです。たとえば、「2025-04-01-preview」のように入力します。

必須のヘッダー:

Content-Type: application/json
api-key: <your_API_key>

本文:

要求本文の例を次に示します。いくつかのオプションを指定します。これらについては、後のセクションで定義します。

{
    "prompt": "A multi-colored umbrella on the beach, disposable camera",
    "model": "gpt-image-1",
    "size": "1024x1024", 
    "n": 1,
    "quality": "high"
}

POST 要求を次の宛先に送信します。

https://<your_resource_name>.openai.azure.com/openai/deployments/<your_deployment_name>/images/generations?api-version=<api_version>

URL:

次の値を置き換えます。

<your_resource_name> は、Azure OpenAI リソースの名前です。
<your_deployment_name> は、DALL-E 3 または GPT-image-1 モデルデプロイの名前です。
<api_version> は、使う API のバージョンです。たとえば、「2024-02-01」のように入力します。

必須のヘッダー:

Content-Type: application/json
api-key: <your_API_key>

本文:

要求本文の例を次に示します。いくつかのオプションを指定します。これらについては、後のセクションで定義します。

{
    "prompt": "A multi-colored umbrella on the beach, disposable camera",
    "size": "1024x1024", 
    "n": 1,
    "quality": "hd", 
    "style": "vivid"
}

ヒント

イメージ生成トークンのコストについては、「イメージトークン」を参照してください。

出力

イメージ生成 API 呼び出しが成功した場合の応答は、次の例のようになります。 url フィールドには、生成画像をダウンロードできる URL が含まれています。 URL は 24 時間アクティブなままです。

{ 
    "created": 1698116662, 
    "data": [ 
        { 
            "url": "<URL_to_generated_image>",
            "revised_prompt": "<prompt_that_was_used>" 
        }
    ]
}

API 呼び出しの拒否

プロンプトと画像は、コンテンツポリシーに基づいてフィルター処理され、プロンプトまたは画像にフラグが設定されるとエラーが返されます。

プロンプトにフラグが設定されている場合、メッセージの error.code 値は contentFilter に設定されます。次に例を示します。

{
    "created": 1698435368,
    "error":
    {
        "code": "contentFilter",
        "message": "Your task failed as a result of our safety system."
    }
}

生成画像自体がフィルター処理される可能性もあります。この場合、エラーメッセージは、"生成された画像は安全システムによりフィルター処理されました" に設定されます。次に例を示します。

{
    "created": 1698435368,
    "error":
    {
        "code": "contentFilter",
        "message": "Generated image was filtered as a result of our safety system."
    }
}

テキストからイメージへのプロンプトを書き込む

プロンプトには、画像に表示するコンテンツと、画像の視覚的なスタイルが記述されている必要があります。

プロンプトを記述するときは、Image API にコンテンツモデレーションフィルターが付属していることを検討してください。サービスがプロンプトを有害なコンテンツとして認識した場合、画像は生成されません。詳細については、「コンテンツのフィルター処理」を参照してください。

ヒント

テキストプロンプトを調整してさまざまな種類の画像を生成する方法については、イメージプロンプトエンジニアリングガイドを参照してください。

API オプションを指定する

イメージ生成モデルでは、次の API 本文パラメーターを使用できます。

GPT-image-1
DALL-E 3

サイズ

生成される画像のサイズを指定します。 GPT-image-1 モデルの 1024x1024、 1024x1536、または 1536x1024 のいずれかである必要があります。正方形の画像は生成が速くなります。

品質

画質には、 low、 medium、 highの 3 つのオプションがあります。低品質の画像をより高速に生成できます。

既定値は high です。

Number

1 つの API 呼び出しで 1 から 10 個のイメージを生成できます。既定値は 1 です。

ユーザーID

ユーザー パラメーターを使用して、要求を行うユーザーの一意の識別子を指定します。これは、使用パターンの追跡と監視に役立ちます。値には、ユーザー ID や電子メールアドレスなどの任意の文字列を指定できます。

出力形式

生成されたイメージの形式を指定するには、 output_format パラメーターを使用します。サポートされている形式は、 PNG と JPEGです。既定値は PNG です。

注

WEBP イメージは、Azure AI Foundry モデルの Azure OpenAI ではサポートされていません。

圧縮

生成されたイメージの圧縮レベルを指定するには、 output_compression パラメーターを使用します。 0と100の間に整数を入力します。ここで、0は圧縮なし、100は最大圧縮です。既定値は 100 です。

サイズ

生成される画像のサイズを指定します。 DALL-E 3 モデルの 1024x1024、1792x1024、または 1024x1792 のいずれかである必要があります。正方形の画像は生成が速くなります。

Style

DALL-E 3 では、natural と vivid の 2 つのスタイルオプションが提供されます。 natural スタイルは旧モデルの既定のスタイルに似ていますが、vivid スタイルでは、よりリアルで映画のような画像が生成されます。

natural スタイルは、よりシンプルで、落ち着いた、またはリアルであることを意図した主題が、DALL-E 3 で誇張または混同される場合に役立ちます。

既定値は vivid です。

品質

画質には、hd と standard の 2 つのオプションがあります。 hd オプションの場合、よりきめ細かく、全体の一貫性が高い画像が作成されます。 standard の画像は、より高速に生成できます。

既定値は standard です。

Number

DALL-E 3 では、1 つの API 呼び出しで複数の画像を生成することはできません。n パラメーターを 1 に設定する必要があります。一度に複数の画像を生成する必要がある場合は、並列要求を実行します。

応答形式

DALL-E 3 で生成されたイメージが返される形式。 url または b64_json のいずれかである必要があります。このパラメーターは、常に base64 でエンコードされたイメージを返す GPT-image-1 ではサポートされていません。

Image Edit API を呼び出す

Image Edit API を使用すると、指定したテキストプロンプトに基づいて既存のイメージを変更できます。 API 呼び出しはイメージ生成 API 呼び出しに似ていますが、入力イメージ (base64 でエンコードされたイメージデータ) も指定する必要があります。

Von Bedeutung

入力イメージのサイズは 20 MB 未満で、PNG または JPG ファイルである必要があります。

GPT-image-1
DALL-E 3

POST 要求を次の宛先に送信します。

https://<your_resource_name>.openai.azure.com/openai/deployments/<your_deployment_name>/images/edits?api-version=<api_version>

URL:

次の値を置き換えます。

<your_resource_name> は、Azure OpenAI リソースの名前です。
<your_deployment_name> は、DALL-E 3 または GPT-image-1 モデルデプロイの名前です。
<api_version> は、使う API のバージョンです。たとえば、「2025-04-01-preview」のように入力します。

必須のヘッダー:

Content-Type: multipart/form-data
api-key: <your_API_key>

本文:

要求本文の例を次に示します。いくつかのオプションを指定します。これらについては、後のセクションで定義します。

Von Bedeutung

Image Edit API は、JSON データではなくマルチパート/フォームデータを受け取ります。次の例は、cURL 要求にアタッチされるサンプルフォームデータを示しています。

-F "image[]=@beach.png" \
-F 'prompt=Add a beach ball in the center' \
-F "model=gpt-image-1" \
-F "size=1024x1024" \
-F "n=1" \
-F "quality=high"

出力

画像編集 API 呼び出しが成功した場合の応答は、次の例のようになります。 url フィールドには、生成画像をダウンロードできる URL が含まれています。 URL は 24 時間アクティブなままです。

{ 
    "created": 1698116662, 
    "data": [ 
        { 
            "url": "<URL_to_generated_image>",
            "revised_prompt": "<prompt_that_was_used>" 
        }
    ]
}

API オプションを指定する

画像生成モデルで使用できるパラメーターに加えて、次の API 本文パラメーターを画像編集モデルで使用できます。

Image

イメージ値は、編集するイメージファイルを示します。イメージファイルの URL 文字列、または base 64 でエンコードされた画像データのいずれかを指定できます。

マスク

mask パラメーターは、メイン イメージ入力パラメーターと同じ型です。これらの領域で完全に透明なピクセル (ゼロのアルファ) を使用して、モデルで編集するイメージの領域を定義します。マスクは、base 64 でエンコードされたイメージである必要があります。 PNG ファイルで、入力イメージと同じサイズにする必要があります。

次の方法で共有

Azure OpenAI イメージ生成モデルを使用する方法

前提条件

イメージ生成 API を呼び出す

出力

API 呼び出しの拒否

テキストからイメージへのプロンプトを書き込む

API オプションを指定する

サイズ

品質

Number

ユーザーID

出力形式

圧縮

Image Edit API を呼び出す

出力

API オプションを指定する

Image

マスク

関連コンテンツ

フィードバック

その他のリソース