модели OpenAI Azure для генерации изображений

Используйте это руководство, чтобы начать вызывать REST API для генерации изображений Azure OpenAI в Microsoft Foundry Models с помощью Python.

Предпосылки

• Подписка Azure. Создать бесплатно.
• Python 3.8 или более поздней версии.
• Установлены следующие библиотеки Python: os, requestsjson.
• Ресурс OpenAI Azure, созданный в поддерживаемом регионе. См. раздел Регион доступности.
• Затем необходимо развернуть модель серии gpt-image-1-с вашим ресурсом Azure. Дополнительные сведения см. в разделе Создание ресурса и развертывание модели с помощью Azure OpenAI.

Настройка

Получение ключа и конечной точки

Чтобы успешно вызвать API-интерфейсы OpenAI Azure, вам потребуется следующая информация о ресурсе OpenAI Azure:

Перейдите к своему ресурсу в портале Azure. На панели навигации выберите "Ключи" и "Конечная точка " в разделе "Управление ресурсами". Скопируйте значение Endpoint и ключа доступа. Вы можете использовать либо значение KEY 1, либо KEY 2. Наличие двух ключей позволяет безопасно менять и повторно создавать ключи без прерывания работы службы.

Переменные среды

Создайте и назначьте переменные постоянной среды для ключа и конечной точки.

setx AZURE_OPENAI_API_KEY "REPLACE_WITH_YOUR_KEY_VALUE_HERE" 
setx AZURE_OPENAI_ENDPOINT "REPLACE_WITH_YOUR_ENDPOINT_HERE" 

[System.Environment]::SetEnvironmentVariable('AZURE_OPENAI_API_KEY', 'REPLACE_WITH_YOUR_KEY_VALUE_HERE', 'User')
[System.Environment]::SetEnvironmentVariable('AZURE_OPENAI_ENDPOINT', 'REPLACE_WITH_YOUR_ENDPOINT_HERE', 'User')

export AZURE_OPENAI_API_KEY="REPLACE_WITH_YOUR_KEY_VALUE_HERE"
export AZURE_OPENAI_ENDPOINT="REPLACE_WITH_YOUR_ENDPOINT_HERE"

Создайте новое приложение на Python

Создайте файл Python с именем quickstart.py. Откройте новый файл в предпочтительном редакторе или интегрированной среде разработки.

1. Замените содержимое quickstart.py следующим кодом. Измените значение prompt на предпочитаемый вами текст. Также задайте deployment наименование развертывания, которое вы выбрали при развертывании модели серии GPT-image-1.

   import os
   import requests
   import base64
   from PIL import Image
   from io import BytesIO
   
   # set environment variables
   endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
   subscription_key = os.getenv("AZURE_OPENAI_API_KEY")
   
   deployment = "gpt-image-1.5" # the name of your GPT-image-1 series deployment
   api_version = "2025-04-01-preview" # or later version
   
   def decode_and_save_image(b64_data, output_filename):
     image = Image.open(BytesIO(base64.b64decode(b64_data)))
     image.show()
     image.save(output_filename)
   
   def save_all_images_from_response(response_data, filename_prefix):
     for idx, item in enumerate(response_data['data']):
       b64_img = item['b64_json']
       filename = f"{filename_prefix}_{idx+1}.png"
       decode_and_save_image(b64_img, filename)
       print(f"Image saved to: '{filename}'")
   
   base_path = f'openai/deployments/{deployment}/images'
   params = f'?api-version={api_version}'
   
   generation_url = f"{endpoint}{base_path}/generations{params}"
   generation_body = {
     "prompt": "girl falling asleep",
     "n": 1,
     "size": "1024x1024",
     "quality": "medium",
     "output_format": "png",
     # "background": "transparent",  # "auto" or "transparent" (requires PNG output)
     # "output_compression": 100,  # 0-100 compression level (JPEG output only)
   }
   generation_response = requests.post(
     generation_url,
     headers={
       'Api-Key': subscription_key,
       'Content-Type': 'application/json',
     },
     json=generation_body
   ).json()
   save_all_images_from_response(generation_response, "generated_image")
   
   # In addition to generating images, you can edit them.
   edit_url = f"{endpoint}{base_path}/edits{params}"
   edit_body = {
     "prompt": "girl falling asleep",
     "n": 1,
     "size": "1024x1024",
     "quality": "medium"
   }
   files = {
     "image": ("generated_image_1.png", open("generated_image_1.png", "rb"), "image/png"),
     # You can use a mask to specify which parts of the image you want to edit.
     # The mask must be the same size as the input image.
     # "mask": ("mask.png", open("mask.png", "rb"), "image/png"),
   }
   edit_response = requests.post(
     edit_url,
     headers={'Api-Key': subscription_key},
     data=edit_body,
     files=files
   ).json()
   save_all_images_from_response(edit_response, "edited_image")
   

   Скрипт выполняет синхронный вызов API создания образов.

   Это важно

   Не забудьте удалить ключ из кода, когда вы закончите, и никогда не публикуйте ключ. Для продакшена используйте безопасный способ хранения и доступа к учетным данным. Дополнительные сведения см. в разделе Azure Key Vault.

2. Запустите приложение, выполнив команду python:

   python quickstart.py
   

   Подождите несколько минут, чтобы получить ответ.

Выходные данные

Выходные данные из успешного вызова API создания изображений выглядят следующим образом. Поле b64_json содержит данные выходных изображений в кодировке Base64.

{ 
    "created": 1698116662, 
    "data": [ 
        { 
            "b64_json": "<base64 image data>"
        }
    ]
} 

Успешный ответ включает в себя:

• Отметка created времени (эпоха Unix)
• data Массив c как минимум одним объектом изображения — значением b64_json (в формате кодировки Base64) для каждого сгенерированного изображения

Распространенные ошибки

API-интерфейсы изображений содержат фильтр модерации содержимого. Если служба распознает запрос как вредное содержимое, она не создает изображение. Дополнительные сведения см. в разделе "Фильтрация содержимого". Примеры ответов на ошибки см. в руководстве по создании образов.

Система возвращает состояние операции Failed и значение error.code в сообщении задается на contentFilter. Приведем пример:

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

Кроме того, возможно, что созданный образ фильтруется. В этом случае сообщение об ошибке установлено на Generated image was filtered as a result of our safety system.. Приведем пример:

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

Очистите ресурсы

Если вы хотите удалить ресурс Azure OpenAI, вы можете удалить сам ресурс или группу ресурсов. Удаление группы ресурсов также удаляет все другие ресурсы, связанные с ней.

• Портал Azure
• Azure CLI

Используйте это руководство для начала работы с генерацией изображений с помощью средства Azure OpenAI SDK для Python.

Исходный код библиотеки | Пакет | Примеры

Предпосылки

• Подписка Azure. Создать бесплатно.
• Python 3.8 или более поздней версии.
• Ресурс OpenAI Azure, созданный в совместимом регионе. См. раздел Регион доступности.
  • Получите доступ к конечной точке и ключам ресурса Azure OpenAI в портале Azure.
• Развернутая модель создания образов:
  • Серия GPT-image-1: разверните модель gpt-image-1-серии. Доступно в ограниченном доступе.
  • Серия GPT-image-1: развертывание gpt-image-1 модели. Требуется регистрация с ограниченным доступом.

Дополнительные сведения см. в разделе Создание ресурса и развертывание модели с помощью Azure OpenAI.

Настройка

Получение ключа и конечной точки

Чтобы успешно вызвать API-интерфейсы OpenAI Azure, вам потребуется следующая информация о ресурсе OpenAI Azure:

Перейдите к своему ресурсу в портале Azure. На панели навигации выберите "Ключи" и "Конечная точка " в разделе "Управление ресурсами". Скопируйте значение Endpoint и ключа доступа. Вы можете использовать либо значение KEY 1, либо KEY 2. Наличие двух ключей позволяет безопасно менять и повторно создавать ключи без прерывания работы службы.

Переменные среды

Создайте и назначьте переменные постоянной среды для ключа и конечной точки.

setx AZURE_OPENAI_API_KEY "REPLACE_WITH_YOUR_KEY_VALUE_HERE" 
setx AZURE_OPENAI_ENDPOINT "REPLACE_WITH_YOUR_ENDPOINT_HERE" 

[System.Environment]::SetEnvironmentVariable('AZURE_OPENAI_API_KEY', 'REPLACE_WITH_YOUR_KEY_VALUE_HERE', 'User')
[System.Environment]::SetEnvironmentVariable('AZURE_OPENAI_ENDPOINT', 'REPLACE_WITH_YOUR_ENDPOINT_HERE', 'User')

export AZURE_OPENAI_API_KEY="REPLACE_WITH_YOUR_KEY_VALUE_HERE"
export AZURE_OPENAI_ENDPOINT="REPLACE_WITH_YOUR_ENDPOINT_HERE"

Установка пакета SDK для Python

Откройте командную строку и перейдите к папке project. Установите пакет SDK Для Python OpenAI с помощью следующей команды:

pip install openai

Установите также следующие библиотеки:

pip install requests
pip install pillow 

Создание изображений

Создайте файл Python quickstart.py. Откройте его в предпочитаемом редакторе или интегрированной среде разработки.

Замените содержимое quickstart.py следующим кодом.

from openai import AzureOpenAI
import os
import base64
from PIL import Image

client = AzureOpenAI(
    api_version="2025-04-01-preview",  
    api_key=os.environ["AZURE_OPENAI_API_KEY"],  
    azure_endpoint=os.environ['AZURE_OPENAI_ENDPOINT']
)

result = client.images.generate(
    model="gpt-image-1", # the name of your GPT-image-1 series deployment
    prompt="a close-up of a bear walking through the forest",
    n=1,
    size="1024x1024",
    quality="high",
    output_format="png",
    # background="transparent",  # Set to "transparent" for transparent backgrounds (requires PNG)
    # output_compression=100,  # 0-100 compression level (JPEG output only)
)

# Set the directory for the stored image
image_dir = os.path.join(os.curdir, 'images')

# If the directory doesn't exist, create it
if not os.path.isdir(image_dir):
    os.mkdir(image_dir)

# Initialize the image path (note the filetype should be png)
image_path = os.path.join(image_dir, 'generated_image.png')

# GPT-image-1 models always return base64-encoded image data
image_base64 = result.data[0].b64_json
generated_image = base64.b64decode(image_base64)
with open(image_path, "wb") as image_file:
    image_file.write(generated_image)

# Display the image in the default image viewer
image = Image.open(image_path)
image.show()

1. Убедитесь, что заданы переменные среды AZURE_OPENAI_ENDPOINT и AZURE_OPENAI_API_KEY.
2. Измените значение prompt на предпочитаемый вами текст.
3. Измените значение model на имя развернутой модели серии GPT-image-1.

Запустите приложение, выполнив команду python:

python quickstart.py

Подождите несколько минут, чтобы получить ответ.

Выходные данные

Azure OpenAI сохраняет выходной образ в файле generated_image.png в указанном каталоге. Сценарий также отображает изображение в средстве просмотра изображений по умолчанию.

Успешный ответ включает в себя:

• Метка created времени
• data Массив с по крайней мере одним объектом изображения
• b64_json Поле с данными изображения в кодировке Base64 (модели GPT-image-1 всегда возвращают base64)

Распространенные ошибки

API-интерфейсы изображений содержат фильтр модерации содержимого. Если служба распознает запрос как вредное содержимое, она не создает изображение. Дополнительные сведения см. в разделе "Фильтрация содержимого".

Очистите ресурсы

Если вы хотите удалить ресурс Azure OpenAI, вы можете удалить сам ресурс или группу ресурсов. Удаление группы ресурсов также удаляет все другие ресурсы, связанные с ней.

• Портал Azure
• Azure CLI

Используйте это руководство, чтобы начать создание изображений с помощью пакета SDK Azure OpenAI для C#.

исходный код Library | Package (NuGet) | Samples

Предпосылки

• Подписка Azure — Создать бесплатно
• Пакет SDK .NET 7
• Ресурс OpenAI Azure, созданный в поддерживаемом регионе (см. Регион доступности). Дополнительные сведения см. в разделе Создание ресурса и развертывание модели с помощью Azure OpenAI.

предварительные требования Microsoft Entra ID

Для рекомендуемой проверки подлинности без ключа с помощью Microsoft Entra ID необходимо:

• Установите Azure CLI, который используется для аутентификации без использования ключей с помощью Microsoft Entra ID.
• Назначьте роль Cognitive Services User своему аккаунту пользователя. Роли можно назначать в Azure portal в разделе Access control (IAM)>Добавить назначение роли.

Настройка

1. Создайте новую папку image-quickstart и перейдите в папку быстрого запуска, используя следующую команду:

   mkdir image-quickstart && cd image-quickstart
   

2. Создайте консольное приложение со следующей командой:

   dotnet new console
   

3. Установите библиотеку клиентов OpenAI .NET с командой dotnet add package:

   dotnet add package Azure.AI.OpenAI --version 1.0.0-beta.6
   

4. Для рекомендуемой безключевой аутентификации с Microsoft Entra ID установите пакет Azure.Identity с помощью:

   dotnet add package Azure.Identity
   

5. Для безключевой аутентификации с помощью Microsoft Entra ID войдите в Azure с помощью следующей команды:

   az login
   

Получение сведений о ресурсе

Чтобы проверить подлинность приложения с помощью ресурса OpenAI Azure, необходимо получить следующие сведения:

Выполните быстрый старт

Пример кода в этом кратком руководстве использует Microsoft Entra ID для рекомендуемой безключевой аутентификации. Если вы предпочитаете использовать ключ API, можно заменить DefaultAzureCredential объект AzureKeyCredential объектом.

AzureOpenAIClient openAIClient = new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential()); 

AzureOpenAIClient openAIClient = new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(key));

Чтобы запустить быстрый старт, выполните следующие действия.

1. Замените содержимое Program.cs следующим кодом и обновите заполнительные значения на собственные.

   using Azure;
   using Azure.AI.OpenAI;
   using OpenAI.Images;
   using static System.Environment;
   
   string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT") ?? "https://<your-resource-name>.openai.azure.com/";
   string key = Environment.GetEnvironmentVariable("AZURE_OPENAI_API_KEY") ?? "<your-key>";
   
   // Use the recommended keyless credential instead of the AzureKeyCredential credential.
   AzureOpenAIClient openAIClient = new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential()); 
   //AzureOpenAIClient openAIClient = new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(key));
   
   // This must match the custom deployment name you chose for your model
   ImageClient chatClient = openAIClient.GetImageClient("gpt-image-1");
   
   var imageGeneration = await chatClient.GenerateImageAsync(
           "a happy monkey sitting in a tree, in watercolor",
           new ImageGenerationOptions()
           {
               Size = GeneratedImageSize.W1024xH1024
           }
       );
   
   Console.WriteLine(imageGeneration.Value.ImageUri);
   

2. Запустите приложение с помощью команды dotnet run или кнопки запуска в верхней части Visual Studio:

   dotnet run
   

Выходные данные

Данные изображения в кодировке Base64 печатаются в консоли.

Очистите ресурсы

Если вы хотите упорядочить и удалить ресурс Azure OpenAI, можно удалить ресурс. Перед удалением ресурса необходимо сначала удалить все развернутые модели.

• Портал Azure
• Azure CLI

Используйте это руководство, чтобы начать создание изображений с помощью Azure OpenAI SDK для Java.

исходный код Library | Artifact (Maven) | Samples

Предпосылки

• Подписка Azure — Создать бесплатно
• Текущая версия пакета средств разработки Java (JDK).
• Установите Apache Maven.
• Ресурс OpenAI Azure, созданный в поддерживаемом регионе (см. Регион доступности). Дополнительные сведения см. в разделе Создание ресурса и развертывание модели с помощью Azure OpenAI.

предварительные требования Microsoft Entra ID

Для рекомендуемой проверки подлинности без ключа с помощью Microsoft Entra ID необходимо:

• Установите Azure CLI, который используется для аутентификации без использования ключей с помощью Microsoft Entra ID.
• Назначьте роль Cognitive Services User своему аккаунту пользователя. Роли можно назначать в Azure portal в разделе Access control (IAM)>Добавить назначение роли.

Настройка

1. Создайте новую папку image-quickstart и перейдите в папку быстрого запуска, используя следующую команду:

   mkdir image-quickstart && cd image-quickstart
   

2. Установите Apache Maven. Затем выполните команду mvn -v , чтобы подтвердить успешную установку.

3. Создайте файл pom.xml в корне project и скопируйте в него следующий код:

   <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0</modelVersion>
        <groupId>com.azure.samples</groupId>
        <artifactId>quickstart-image-generation</artifactId>
        <version>1.0.0-SNAPSHOT</version>
        <build>
            <sourceDirectory>src</sourceDirectory>
            <plugins>
            <plugin>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.7.0</version>
                <configuration>
                <source>1.8</source>
                <target>1.8</target>
                </configuration>
            </plugin>
            </plugins>
        </build>
        <dependencies>    
            <dependency>
                <groupId>com.azure</groupId>
                <artifactId>azure-ai-openai</artifactId>
                <version>1.0.0-beta.3</version>
            </dependency>
            <dependency>
                <groupId>com.azure</groupId>
                <artifactId>azure-core</artifactId>
                <version>1.53.0</version>
            </dependency>
            <dependency>
                <groupId>com.azure</groupId>
                <artifactId>azure-identity</artifactId>
                <version>1.15.1</version>
            </dependency>
            <dependency>
                <groupId>org.slf4j</groupId>
                <artifactId>slf4j-simple</artifactId>
                <version>1.7.9</version>
            </dependency>
        </dependencies>
    </project>
   

4. Установите SDK Azure OpenAI и его зависимости.

   mvn clean dependency:copy-dependencies
   

5. Для безключевой аутентификации с помощью Microsoft Entra ID войдите в Azure с помощью следующей команды:

   az login
   

Получение сведений о ресурсе

Чтобы проверить подлинность приложения с помощью ресурса OpenAI Azure, необходимо получить следующие сведения:

Запуск приложения

Пример кода в этом кратком руководстве использует Microsoft Entra ID для рекомендуемой безключевой аутентификации. Если вы предпочитаете использовать ключ API, можно заменить DefaultAzureCredential объект AzureKeyCredential объектом.

OpenAIAsyncClient client = new OpenAIClientBuilder()
    .endpoint(endpoint)
    .credential(new DefaultAzureCredentialBuilder().build())
    .buildAsyncClient();

OpenAIAsyncClient client = new OpenAIClientBuilder()
    .endpoint(endpoint)
    .credential(new AzureKeyCredential(key))
    .buildAsyncClient();

Выходные данные

URL-адрес созданного изображения выводится в консоль.

Image location URL that provides temporary access to download the generated image is <SAS URL>.
Completed getImages.

Очистите ресурсы

Если вы хотите упорядочить и удалить ресурс Azure OpenAI, можно удалить ресурс. Перед удалением ресурса необходимо сначала удалить все развернутые модели.

• Портал Azure
• Azure CLI

Используйте это руководство, чтобы начать создавать изображения с помощью пакета SDK Azure OpenAI для JavaScript.

Справочная документация | Исходный код | Пакет (npm) | Примеры

Предпосылки

• Подписка Azure — Создать бесплатно
• LTS версии Node.js
• Azure CLI используется для проверки подлинности без пароля в локальной среде разработки, создайте необходимый контекст, выполнив вход с помощью Azure CLI.
• Ресурс OpenAI Azure, созданный в поддерживаемом регионе (см. Регион доступности). Дополнительные сведения см. в разделе Создание ресурса и развертывание модели с помощью Azure OpenAI.

предварительные требования Microsoft Entra ID

Для рекомендуемой проверки подлинности без ключа с помощью Microsoft Entra ID необходимо:

• Установите Azure CLI, который используется для аутентификации без использования ключей с помощью Microsoft Entra ID.
• Назначьте роль Cognitive Services User своему аккаунту пользователя. Роли можно назначать в Azure portal в разделе Access control (IAM)>Добавить назначение роли.

Настройка

1. Создайте новую папку image-quickstart и перейдите в папку быстрого запуска, используя следующую команду:

   mkdir image-quickstart && cd image-quickstart
   

2. Создайте package.json с помощью следующей команды:

   npm init -y
   

3. Установите клиентскую библиотеку OpenAI для JavaScript с помощью:

   npm install openai
   

4. Для рекомендуемой аутентификации без пароля:

   npm install @azure/identity
   

Получение сведений о ресурсе

Чтобы проверить подлинность приложения с помощью ресурса OpenAI Azure, необходимо получить следующие сведения:

Создание изображений

Выходные данные

Сгенерированное изображение сохранён в generated_image.png в текущем каталоге.

== Image Generation ==
Image saved to generated_image.png

Очистите ресурсы

Если вы хотите упорядочить и удалить ресурс Azure OpenAI, можно удалить ресурс. Перед удалением ресурса необходимо сначала удалить все развернутые модели.

• Портал Azure
• Azure CLI

Используйте это руководство, чтобы начать создавать изображения с помощью пакета SDK Azure OpenAI для JavaScript.

Справочная документация | Исходный код | Пакет (npm) | Примеры

Предпосылки

• Подписка Azure — Создать бесплатно
• LTS версии Node.js
• TypeScript
• Azure CLI используется для проверки подлинности без пароля в локальной среде разработки, создайте необходимый контекст, выполнив вход с помощью Azure CLI.
• Ресурс OpenAI Azure, созданный в поддерживаемом регионе (см. Регион доступности). Дополнительные сведения см. в разделе Создание ресурса и развертывание модели с помощью Azure OpenAI.

предварительные требования Microsoft Entra ID

Для рекомендуемой проверки подлинности без ключа с помощью Microsoft Entra ID необходимо:

• Установите Azure CLI, который используется для аутентификации без использования ключей с помощью Microsoft Entra ID.
• Назначьте роль Cognitive Services User своему аккаунту пользователя. Роли можно назначать в Azure portal в разделе Access control (IAM)>Добавить назначение роли.

Настройка

1. Создайте новую папку image-quickstart и перейдите в папку быстрого запуска, используя следующую команду:

   mkdir image-quickstart && cd image-quickstart
   

2. Создайте package.json с помощью следующей команды:

   npm init -y
   

3. Обновите package.json на ECMAScript с помощью следующей команды:

   npm pkg set type=module
   

4. Установите клиентскую библиотеку OpenAI для JavaScript с помощью:

   npm install openai
   

5. Для рекомендуемой аутентификации без пароля:

   npm install @azure/identity
   

Получение сведений о ресурсе

Чтобы проверить подлинность приложения с помощью ресурса OpenAI Azure, необходимо получить следующие сведения:

Создание изображений

Выходные данные

Сгенерированное изображение сохранён в generated_image.png в текущем каталоге.

== Image Generation ==
Image saved to generated_image.png

Очистите ресурсы

Если вы хотите упорядочить и удалить ресурс Azure OpenAI, можно удалить ресурс. Перед удалением ресурса необходимо сначала удалить все развернутые модели.

• Портал Azure
• Azure CLI

Используйте это руководство для начала генерации изображений с помощью пакета SDK Azure OpenAI для Go.

Исходный код библиотеки | Пакет | Примеры

Предпосылки

• Подписка Azure — Создать бесплатно
• Go 1.8 или более поздней версии
• Ресурс OpenAI Azure, созданный в поддерживаемом регионе (см. Регион доступности). Дополнительные сведения см. в разделе Создание ресурса и развертывание модели с помощью Azure OpenAI.

предварительные требования Microsoft Entra ID

Для рекомендуемой проверки подлинности без ключа с помощью Microsoft Entra ID необходимо:

• Установите Azure CLI, который используется для аутентификации без использования ключей с помощью Microsoft Entra ID.
• Назначьте роль Cognitive Services User своему аккаунту пользователя. Роли можно назначать в Azure portal в разделе Access control (IAM)>Добавить назначение роли.

Настройка

1. Создайте новую папку dall-e-quickstart и перейдите в папку быстрого запуска, используя следующую команду:

   mkdir dall-e-quickstart && cd dall-e-quickstart
   

2. Для безключевой аутентификации с помощью Microsoft Entra ID войдите в Azure с помощью следующей команды:

   az login
   

Получение сведений о ресурсе

Чтобы проверить подлинность приложения с помощью ресурса OpenAI Azure, необходимо получить следующие сведения:

Выполните быстрый старт

Пример кода в этом кратком руководстве использует Microsoft Entra ID для рекомендуемой безключевой аутентификации. Если вы предпочитаете использовать ключ API, вы можете заменить реализацию NewDefaultAzureCredential на NewKeyCredential.

azureOpenAIEndpoint := os.Getenv("AZURE_OPENAI_ENDPOINT")
credential, err := azidentity.NewDefaultAzureCredential(nil)
client, err := azopenai.NewClient(azureOpenAIEndpoint, credential, nil)

azureOpenAIEndpoint := os.Getenv("AZURE_OPENAI_ENDPOINT")
azureOpenAIKey := os.Getenv("AZURE_OPENAI_API_KEY")
credential := azcore.NewKeyCredential(azureOpenAIKey)
client, err := azopenai.NewClientWithKeyCredential(azureOpenAIEndpoint, credential, nil)

Выходные данные

URL-адрес созданного изображения выводится в консоль.

Image generated, HEAD request on URL returned 200
Image URL: <SAS URL>

Очистите ресурсы

Если вы хотите удалить ресурс Azure OpenAI, вы можете удалить сам ресурс или группу ресурсов. Удаление группы ресурсов также удаляет все другие ресурсы, связанные с ней.

• Портал Azure
• Azure CLI

Используйте это руководство, чтобы начать работу с вызовами API для создания изображений Azure OpenAI в Microsoft Foundry Models с помощью PowerShell.

Предпосылки

• Подписка Azure. Создать бесплатно.
• Для этой задачи рекомендуется использовать последнюю версию PowerShell 7, так как в примерах используются новые функции, недоступные в Windows PowerShell 5.1.
• Ресурс OpenAI Azure, созданный в поддерживаемом регионе (см. Регион доступности). Дополнительные сведения см. в разделе Создание ресурса и развертывание модели с помощью Azure OpenAI.

предварительные требования Microsoft Entra ID

Для рекомендуемой проверки подлинности без ключа с помощью Microsoft Entra ID необходимо:

• Установите Azure CLI, который используется для аутентификации без использования ключей с помощью Microsoft Entra ID.
• Назначьте роль Cognitive Services User своему аккаунту пользователя. Роли можно назначать в Azure portal в разделе Access control (IAM)>Добавить назначение роли.

Получение сведений о ресурсе

Чтобы проверить подлинность приложения с помощью ресурса OpenAI Azure, необходимо получить следующие сведения:

Создание изображений

1. Для безключевой аутентификации с помощью Microsoft Entra ID войдите в Azure с помощью следующей команды:

   az login
   

2. Получите маркер проверки подлинности OpenAI Azure и задайте его в качестве переменной среды для текущего сеанса PowerShell:

   $Env:DEFAULT_AZURE_CREDENTIAL_TOKEN = az account get-access-token --resource https://cognitiveservices.azure.com --query accessToken -o tsv
   

3. Создайте новый файл PowerShell с именемquickstart.ps1. Затем откройте его в предпочитаемом редакторе или интегрированной среде разработки.

4. Замените содержимое quickstart.ps1 следующим кодом. Убедитесь, что AZURE_OPENAI_ENDPOINT установлен, и измените значение prompt на предпочитаемый вами текст.

   Чтобы использовать проверку подлинности с ключом API вместо проверки без ключа, задайте AZURE_OPENAI_API_KEY и уберите комментарий со строки 'api-key'.

    # Azure OpenAI metadata variables
    $openai = @{
        api_base    = $Env:AZURE_OPENAI_ENDPOINT 
        api_version = '2025-04-01-preview'
        deployment  = 'gpt-image-1' # the name of your GPT-image-1 series deployment
    }
   
    # Use the recommended keyless authentication via bearer token.
    $headers = [ordered]@{
        #'api-key' = $Env:AZURE_OPENAI_API_KEY
        'Authorization' = "Bearer $($Env:DEFAULT_AZURE_CREDENTIAL_TOKEN)"
    }
   
    # Text to describe image
    $prompt = 'A painting of a dog'
   
    # Adjust these values to fine-tune completions
    $body = [ordered]@{
        prompt = $prompt
        size   = '1024x1024'
        n      = 1
        quality = 'high'
        output_format = 'png'
        # background = 'transparent'  # 'auto' or 'transparent' (requires PNG output)
        # output_compression = 100    # 0-100 compression level (JPEG output only)
    } | ConvertTo-Json
   
    # Call the API to generate the image and retrieve the response
    $url = "$($openai.api_base)/openai/deployments/$($openai.deployment)/images/generations?api-version=$($openai.api_version)"
   
    $response = Invoke-RestMethod -Uri $url -Headers $headers -Body $body -Method Post -ContentType 'application/json'
   
    # Set the directory for the stored image
    $image_dir = Join-Path -Path $pwd -ChildPath 'images'
   
    # If the directory doesn't exist, create it
    if (-not(Resolve-Path $image_dir -ErrorAction Ignore)) {
        New-Item -Path $image_dir -ItemType Directory
    }
   
    # Initialize the image path (note the filetype should be png)
    $image_path = Join-Path -Path $image_dir -ChildPath 'generated_image.png'
   
    # Decode the base64 image and save to file
    $image_bytes = [Convert]::FromBase64String($response.data[0].b64_json)
    [IO.File]::WriteAllBytes($image_path, $image_bytes)
    return $image_path
   

   Это важно

   Для рабочей среды используйте безопасный способ хранения и доступа к учетным данным, таким как Управление секретами PowerShell с помощью Azure Key Vault. Дополнительные сведения о безопасности учетных данных см. в этой статье.

5. Запустите скрипт с помощью PowerShell:

   ./quickstart.ps1
   

   Скрипт создает изображение и сохраняет его.

Выходные данные

PowerShell запрашивает образ из Azure OpenAI и сохраняет выходной образ в файле generated_image.png в указанном каталоге. Для удобства полный путь к файлу возвращается в конце скрипта.

API-интерфейсы изображений содержат фильтр модерации содержимого. Если служба распознает запрос как вредное содержимое, она не создает изображение. Дополнительные сведения см. в разделе "Фильтрация содержимого".

Очистите ресурсы

Если вы хотите удалить ресурс Azure OpenAI, вы можете удалить сам ресурс или группу ресурсов. Удаление группы ресурсов также удаляет все другие ресурсы, связанные с ней.

• Портал Azure
• Azure PowerShell

Используйте это руководство для начала работы по генерации изображений с Azure OpenAI в браузере с использованием Microsoft Foundry.

Предпосылки

• Подписка Azure. Создать бесплатно.
• Ресурс OpenAI Azure, созданный в поддерживаемом регионе. См. раздел Регион доступности. Дополнительные сведения см. в разделе Создание ресурса и развертывание модели с помощью Azure OpenAI.

Перейти к Foundry

Перейдите к Foundry и войдите с учетными данными, связанными с ресурсом OpenAI Azure. Во время или после рабочего процесса входа выберите соответствующий каталог, подписку Azure и ресурс Azure OpenAI.

На целевой странице Foundry создайте или выберите новый проект. Перейдите на страницу "Модели + конечные точки" на левой панели навигации . Выберите «Развернуть модель» и затем выберите одну из моделей серии GPT-Image-1 из списка. Завершите процесс развертывания.

На странице модели выберите "Открыть на детской площадке".

Попробуйте создание образа

Начните изучать возможности Azure OpenAI с использованием подхода без кода с помощью Images Playground. Введите запрос изображения в текстовое поле и нажмите кнопку "Создать". Когда изображение, созданное СИ, будет готово, оно отображается на странице.

На игровой площадке "Изображения" можно также просматривать примеры кода Python и cURL, которые предварительно заполнены в соответствии с параметрами. Выберите "Просмотреть код " в верхней части страницы. Этот код можно использовать для записи приложения, которое завершает ту же задачу.

Очистите ресурсы

Если вы хотите удалить ресурс Azure OpenAI, вы можете удалить сам ресурс или группу ресурсов. Удаление группы ресурсов также удаляет все другие ресурсы, связанные с ней.

• Портал Azure
• Azure CLI