Merge pull request #647 from cdpark/refresh-sept-patrickfarley-4

Feature 308280: Q&M: AI Services freshness for 180d target - Batch 4

Author: prmerger-automator[bot]

articles/ai-services/openai/how-to/dall-e.md

@@ -7,14 +7,14 @@ ms.author: pafarley
 ms.service: azure-ai-openai
 ms.custom: 
 ms.topic: how-to
-ms.date: 03/04/2024
+ms.date: 10/02/2024
 manager: nitinme
 keywords: 
 zone_pivot_groups: 
 # Customer intent: as an engineer or hobbyist, I want to know how to use DALL-E image generation models to their full capability.
 ---
 
-# Learn how to work with the DALL-E models
+# How to work with the DALL-E models
 
 OpenAI's DALL-E models generate images based on user-provided text prompts. This guide demonstrates how to use the DALL-E models and configure their options through REST API calls.
 
@@ -23,14 +23,14 @@ OpenAI's DALL-E models generate images based on user-provided text prompts. This
 
 #### [DALL-E 3](#tab/dalle3)
 
-- An Azure subscription. <a href="https://azure.microsoft.com/free/ai-services" target="_blank">Create one for free</a>.
-- An Azure OpenAI resource created in the `SwedenCentral` region.
-- Then, you need to deploy a `dalle3` model with your Azure resource. For more information, see [Create a resource and deploy a model with Azure OpenAI](../how-to/create-resource.md).
+- An Azure subscription. You can [create one for free](https://azure.microsoft.com/pricing/purchase-options/azure-account?icid=ai-services).
+- An Azure OpenAI resource created in the *Sweden Central* region. For more information, see [Create and deploy an Azure OpenAI Service resource](../how-to/create-resource.md).
+- Deploy a *dall-e-3* model with your Azure OpenAI resource.
 
 #### [DALL-E 2 (preview)](#tab/dalle2)
 
-- An Azure subscription. <a href="https://azure.microsoft.com/free/ai-services" target="_blank">Create one for free</a>.
-- An Azure OpenAI resource created in the East US region. For more information, see [Create a resource and deploy a model with Azure OpenAI](../how-to/create-resource.md).
+- An Azure subscription. You can [create one for free](https://azure.microsoft.com/pricing/purchase-options/azure-account?icid=ai-services).
+- An Azure OpenAI resource created in the *East US* region. For more information, see [Create and deploy an Azure OpenAI Service resource](../how-to/create-resource.md).
 
 ---
 
@@ -41,14 +41,13 @@ The following command shows the most basic way to use DALL-E with code. If this
 
 #### [DALL-E 3](#tab/dalle3)
 
-
 Send a POST request to:
 
 ```
 https://<your_resource_name>.openai.azure.com/openai/deployments/<your_deployment_name>/images/generations?api-version=<api_version>
 ```
 
-where:
+**Replace the following placeholders**:
 - `<your_resource_name>` is the name of your Azure OpenAI resource.
 - `<your_deployment_name>` is the name of your DALL-E 3 model deployment.
 - `<api_version>` is the version of the API you want to use. For example, `2024-02-01`.
@@ -82,7 +81,7 @@ First, send a POST request to:
 https://<your_resource_name>.openai.azure.com/openai/images/generations:submit?api-version=<api_version>
 ```
 
-where:
+**Replace the following placeholders**:
 - `<your_resource_name>` is the name of your Azure OpenAI resource.
 - `<api_version>` is the version of the API you want to use. For example, `2023-06-01-preview`.
 
@@ -106,7 +105,7 @@ The operation returns a `202` status code and a JSON object containing the ID an
 
 ```json
 {
-  "id": "f508bcf2-e651-4b4b-85a7-58ad77981ffa",
+  "id": "3d3d3d3d-4444-eeee-5555-6f6f6f6f6f6f",
   "status": "notRunning"
 }
 ```
@@ -117,7 +116,7 @@ To retrieve the image generation results, make a GET request to:
 GET https://<your_resource_name>.openai.azure.com/openai/operations/images/<operation_id>?api-version=<api_version>
 ```
 
-where:
+**Replace the following placeholders**:
 - `<your_resource_name>` is the name of your Azure OpenAI resource.
 - `<operation_id>` is the ID of the operation returned in the previous step.
 - `<api_version>` is the version of the API you want to use. For example, `2023-06-01-preview`.
@@ -135,7 +134,6 @@ The response from this API call contains your generated image.
 
 The output from a successful image generation API call looks like the following example. The `url` field contains a URL where you can download the generated image. The URL stays active for 24 hours.
 
-
 #### [DALL-E 3](#tab/dalle3)
 
 ```json
@@ -173,7 +171,6 @@ The output from a successful image generation API call looks like the following
 ---
 
 
-
 ### API call rejection
 
 Prompts and images are filtered based on our content policy, returning an error when a prompt or image is flagged.
@@ -202,14 +199,14 @@ If your prompt is flagged, the `error.code` value in the message is set to `cont
        "code": "contentFilter",
        "message": "Your task failed as a result of our safety system."
    },
-   "id": "9484f239-9a05-41ba-997b-78252fec4b34",
+   "id": "4e4e4e4e-5555-ffff-6666-7a7a7a7a7a7a",
    "status": "failed"
 }
 ```
 
 ---
 
-It's also possible that the generated image itself is filtered. In this case, the error message is set to `Generated image was filtered as a result of our safety system.`. Here's an example:
+It's also possible that the generated image itself is filtered. In this case, the error message is set to *Generated image was filtered as a result of our safety system*. Here's an example:
 
 #### [DALL-E 3](#tab/dalle3)
 
@@ -230,7 +227,7 @@ It's also possible that the generated image itself is filtered. In this case, th
 {
    "created": 1589478378,
    "expires": 1589478399,
-   "id": "9484f239-9a05-41ba-997b-78252fec4b34",
+   "id": "4e4e4e4e-5555-ffff-6666-7a7a7a7a7a7a",
    "lastActionDateTime": 1589478378,
    "data": [
        {
@@ -251,7 +248,7 @@ It's also possible that the generated image itself is filtered. In this case, th
 
 ## Writing image prompts
 
-Your image prompts should describe the content you want to see in the image, as well as the visual style of image. 
+Your image prompts should describe the content you want to see in the image, and the visual style of image.
 
 When writing prompts, consider that the image generation APIs come with a content moderation filter. If the service recognizes your prompt as harmful content, it doesn't generate an image. For more information, see [Content filtering](../concepts/content-filter.md).
 
@@ -269,24 +266,23 @@ The following API body parameters are available for DALL-E image generation.
 
 Specify the size of the generated images. Must be one of `1024x1024`, `1792x1024`, or `1024x1792` for DALL-E 3 models. Square images are faster to generate.
 
-
 ### Style
 
-DALL-E 3 introduces two style options: `natural` and `vivid`. The `natural` style is more similar to the DALL-E 2 default style, while the `vivid` style generates more hyper-real and cinematic images.
+DALL-E 3 introduces two style options: `natural` and `vivid`. The natural style is more similar to the DALL-E 2 default style, while the vivid style generates more hyper-real and cinematic images.
 
-The `natural` style is useful in cases where DALL-E 3 over-exaggerates or confuses a subject that's meant to be more simple, subdued, or realistic.
+The natural style is useful in cases where DALL-E 3 over-exaggerates or confuses a subject that's meant to be more simple, subdued, or realistic.
 
 The default value is `vivid`.
 
 ### Quality
 
-There are two options for image quality: `hd` and `standard`. `hd` creates images with finer details and greater consistency across the image. `standard` images can be generated faster.
+There are two options for image quality: `hd` and `standard`. The hd option creates images with finer details and greater consistency across the image. Standard images can be generated faster.
 
 The default value is `standard`.
 
 ### Number
 
-With DALL-E 3, you cannot generate more than one image in a single API call: the _n_ parameter must be set to `1`. If you need to generate multiple images at once, make parallel requests.
+With DALL-E 3, you can't generate more than one image in a single API call: the `n` parameter must be set to *1*. If you need to generate multiple images at once, make parallel requests.
 
 ### Response format
 
@@ -300,18 +296,17 @@ Specify the size of the generated images. Must be one of `256x256`, `512x512`, o
 
 ### Number
 
-Set the _n_ parameter to an integer between 1 and 10 to generate multiple images at the same time using DALL-E 2. The images will share an operation ID; you receive them all with the same retrieval API call.
+Set the `n` parameter to an integer between 1 and 10 to generate multiple images at the same time using DALL-E 2. The images share an operation ID; you receive them all with the same retrieval API call.
 
 ---
 
-## Next steps
+## Related content
 
-* [Learn more about Azure OpenAI](../overview.md).
-* [DALL-E quickstart](../dall-e-quickstart.md)
+* [What is Azure OpenAI Service?](../overview.md)
+* [Quickstart: Generate images with Azure OpenAI Service](../dall-e-quickstart.md)
 * [Image generation API reference](/azure/ai-services/openai/reference#image-generation)
 
 
 <!-- OAI HT guide https://platform.openai.com/docs/guides/images/usage
 dall-e 3 features here: https://cookbook.openai.com/articles/what_is_new_with_dalle_3 -->
 
-