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

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

Необходимые условия

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

Установка

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

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

Перейдите к ресурсу на портале Azure. На панели навигации выберите "Ключи" и "Конечная точка " в разделе "Управление ресурсами". Скопируйте значение конечной точки и значение ключа доступа. Можно использовать значение 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 имя развертывания, которое вы выбрали при развертывании модели генерации изображений.

   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 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" (GPT-image-1 only; 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 Массив с по крайней мере одним объектом изображения — значением b64_json (в кодировке Base64) для каждого созданного изображения

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

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

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

{
    "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

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

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

Необходимые условия

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

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

Установка

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

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

Перейдите к ресурсу на портале Azure. На панели навигации выберите "Ключи" и "Конечная точка " в разделе "Управление ресурсами". Скопируйте значение конечной точки и значение ключа доступа. Можно использовать значение 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

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

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 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 (GPT-image-1 only; 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.

Запустите приложение командой python.

python quickstart.py

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

Выход

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

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

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

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

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

Очистка ресурсов

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

• портал Azure
• Azure CLI

Запустите это руководство, чтобы приступить к генерации изображений с помощью Azure OpenAI SDK для 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 в разделе Access control (IAM)>Add role assignment.

Настройка

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

Используйте это руководство, чтобы приступить к созданию образов с помощью пакета SDK openAI Azure для 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 в разделе Access control (IAM)>Add role assignment.

Настройка

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

   mkdir image-quickstart && cd image-quickstart
   

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

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

   <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 OpenAI для JavaScript Azure.

документация Референсная документация | Исходный код | Пакет (npm) | Примеры

Необходимые условия

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

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

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

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

Установка

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 OpenAI для JavaScript Azure.

документация Референсная документация | Исходный код | Пакет (npm) | Примеры

Необходимые условия

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

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

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

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

Установка

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

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

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

Необходимые условия

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

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

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

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

Установка

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 в разделе Access control (IAM)>Add role assignment.

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

Чтобы проверить подлинность приложения с помощью ресурса 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 
        deployment  = 'gpt-image-1' # set to the name of your model 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]@{
        model  = $openai.deployment  # required: the name of your model deployment
        prompt = $prompt
        size   = '1024x1024'
        n      = 1
        quality = 'high'
        output_format = 'png'
        # background = 'transparent'  # 'auto' or 'transparent' (GPT-image-1 only; 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/v1/images/generations?api-version=preview"
   
    $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 и войдите с учетными данными, связанными с ресурсом OpenAI Azure. Во время или после рабочего процесса входа выберите соответствующую директорию, подписку Azure и ресурс Azure OpenAI.

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

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

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

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

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

Очистка ресурсов

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

• портал Azure
• Azure CLI