Mulai cepat: Menghasilkan gambar dengan Azure OpenAI Service

Gunakan panduan ini untuk mulai menghasilkan gambar dengan Azure OpenAI di browser Anda.

Prasyarat

DALL-E 3
DALL-E 2 (pratinjau)

Langganan Azure. Buat akun gratis.
Akses yang diberikan ke DALL-E dalam langganan Azure yang diinginkan.
Sumber daya Azure OpenAI yang dibuat di EastUSwilayah , , AustraliaEastatau SwedenCentral .
Kemudian, Anda perlu menyebarkan dalle3 model dengan sumber daya Azure Anda. Untuk informasi selengkapnya, lihat Membuat sumber daya dan menyebarkan model dengan Azure OpenAI.

Catatan

Saat ini, Anda harus mengirimkan aplikasi untuk mengakses Layanan Azure OpenAI. Untuk mengajukan akses, lengkapi formulir ini. Jika Anda memerlukan bantuan, buka masalah pada repositori ini untuk menghubungi Microsoft.

Buka Azure OpenAI Studio

Telusuri ke Azure OpenAI Studio dan masuk dengan kredensial yang terkait dengan sumber daya Azure OpenAI Anda. Selama atau setelah alur kerja masuk, pilih direktori, langganan Azure, dan sumber daya Azure OpenAI yang sesuai.

DALL-E 3
DALL-E 2 (pratinjau)

Dari halaman arahan Azure OpenAI Studio, pilih DALL· E playground (Pratinjau) untuk menggunakan API pembuatan gambar. Pilih Pengaturan di dekat bagian atas halaman dan konfirmasikan bahwa dropdown Penyebaran telah memilih penyebaran DALL-E 3 Anda.

Mencoba pembuatan gambar

Mulai jelajahi kemampuan Azure OpenAI dengan pendekatan tanpa kode melalui DALL· E playground (Pratinjau). Masukkan prompt gambar Anda ke dalam kotak teks dan pilih Buat. Saat gambar yang dihasilkan AI siap, gambar tersebut akan muncul di halaman.

Catatan

API pembuatan gambar dilengkapi dengan filter moderasi konten. Jika Azure OpenAI mengenali permintaan Anda sebagai konten berbahaya, azure OpenAI tidak mengembalikan gambar yang dihasilkan. Untuk informasi selengkapnya, lihat Pemfilteran konten.

Dalam DALL· E playground (Pratinjau), Anda juga dapat melihat sampel kode Python dan cURL, yang telah diisi sebelumnya sesuai dengan pengaturan Anda. Pilih Tampilkan kode di dekat bagian atas halaman. Anda dapat menggunakan kode ini untuk menulis aplikasi yang menyelesaikan tugas yang sama.

Membersihkan sumber daya

Jika Anda ingin membersihkan dan menghapus sumber daya Azure OpenAI, Anda dapat menghapus sumber daya atau grup sumber daya. Menghapus grup sumber daya juga menghapus sumber daya apa pun yang terkait dengannya.

Langkah berikutnya

Jelajahi API pembuatan gambar secara lebih mendalam dengan panduan cara KERJA DALL-E.
Coba contoh di repositori GitHub Sampel Azure OpenAI.
Lihat referensi API

Gunakan panduan ini untuk mulai memanggil REST API pembuatan gambar Azure OpenAI Service dengan menggunakan Python.

Langganan Azure. Buat akun gratis.
Akses yang diberikan ke DALL-E dalam langganan Azure yang diinginkan. Saat ini, akses ke layanan ini hanya diberikan oleh aplikasi. Anda dapat mengajukan permohonan akses ke Azure OpenAI dengan melengkapi formulir di https://aka.ms/oai/access. Pelanggan lama Azure OpenAI perlu mengajukan ulang formulir untuk mendapatkan akses ke DALL-E. Buka masalah pada repositori ini untuk menghubungi kami jika Anda mengalami masalah.
Python 3.8 atau versi yang lebih baru.
Pustaka Python berikut diinstal: os, , requestsjson.
Sumber daya Azure OpenAI yang dibuat di EastUSwilayah , , AustraliaEastatau SwedenCentral .
Kemudian, Anda perlu menyebarkan dalle3 model dengan sumber daya Azure Anda. Untuk informasi selengkapnya, lihat Membuat sumber daya dan menyebarkan model dengan Azure OpenAI.

Langganan Azure. Buat akun gratis.
Akses yang diberikan ke DALL-E dalam langganan Azure yang diinginkan. Saat ini, akses ke layanan ini hanya diberikan oleh aplikasi. Anda dapat mengajukan permohonan akses ke Azure OpenAI dengan melengkapi formulir di https://aka.ms/oai/access. Pelanggan lama Azure OpenAI perlu mengajukan ulang formulir untuk mendapatkan akses ke DALL-E. Buka masalah pada repositori ini untuk menghubungi kami jika Anda mengalami masalah.
Python 3.8 atau versi yang lebih baru.
Pustaka Python berikut diinstal: os, , requestsjson.
Sumber daya Azure OpenAI dibuat di wilayah US Timur. Untuk informasi selengkapnya, lihat Membuat sumber daya dan menyebarkan model dengan Azure OpenAI.

Catatan

Saat ini, Anda harus mengirimkan aplikasi untuk mengakses Layanan Azure OpenAI. Untuk mengajukan akses, lengkapi formulir di https://aka.ms/oai/access. Jika Anda memerlukan bantuan, buka masalah pada repositori ini untuk menghubungi Microsoft.

Siapkan

Mengambil kunci dan titik akhir

Agar berhasil memanggil API Azure OpenAI, Anda memerlukan informasi berikut tentang sumber daya Azure OpenAI Anda:

Variabel	Nama	Nilai
Endpoint	`api_base`	Nilai titik akhir terletak di bawah Kunci dan Titik Akhir untuk sumber daya Anda di portal Azure. Atau, Anda dapat menemukan nilai di Azure OpenAI Studio>Playground>Tampilan Kode. Contoh titik akhir adalah: `https://docs-test-001.openai.azure.com/`.
Kunci	`api_key`	Nilai kunci juga terletak di bawah Kunci dan Titik Akhir untuk sumber daya Anda di portal Azure. Azure menghasilkan dua kunci untuk sumber daya Anda. Anda dapat menggunakan salah satu nilai.

Buka sumber daya Anda di portal Azure. Pada panel navigasi, pilih Kunci dan Titik Akhir di bawah Manajemen Sumber Daya. Salin nilai Titik akhir dan nilai kunci akses. Anda dapat menggunakan nilai KEY 1 atau KEY 2 . Selalu miliki dua kunci untuk memungkinkan Anda memutar dan meregenerasi kunci dengan aman tanpa menyebabkan gangguan layanan.

Variabel lingkungan

Buat dan tetapkan variabel lingkungan persisten untuk kunci dan titik akhir Anda.

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"

Membuat aplikasi Python baru

Buat file Python baru bernama quickstart.py. Buka file baru di editor atau IDE pilihan Anda.

Ganti konten quickstart.py dengan kode berikut. Ubah nilai prompt menjadi teks pilihan Anda.

DALL-E 3
DALL-E 2 (pratinjau)

Anda juga perlu mengganti <dalle3> di URL dengan nama penyebaran yang Anda pilih saat menyebarkan model DALL-E 3. Memasukkan nama model akan mengakibatkan kesalahan kecuali Anda memilih nama penyebaran yang identik dengan nama model yang mendasar. Jika Anda mengalami kesalahan, periksa kembali untuk memastikan bahwa Anda tidak memiliki penggandaan / pada pemisahan antara titik akhir Anda dan /openai/deployments.

import requests
import time
import os
api_base = os.environ['AZURE_OPENAI_ENDPOINT']  # Enter your endpoint here
api_key = os.environ['AZURE_OPENAI_API_KEY']         # Enter your API key here

api_version = '2024-02-01'
url = f"{api_base}/openai/deployments/<dalle3>/images/generations?api-version={api_version}"
headers= { "api-key": api_key, "Content-Type": "application/json" }
body = {
    # Enter your prompt text here
    "prompt": "A multi-colored umbrella on the beach, disposable camera",
    "size": "1024x1024", # supported values are “1792x1024”, “1024x1024” and “1024x1792” 
    "n": 1, #The number of images to generate. Only n=1 is supported for DALL-E 3.
    "quality": "hd", # Options are “hd” and “standard”; defaults to standard 
    "style": "vivid" # Options are “natural” and “vivid”; defaults to “vivid”
}
submission = requests.post(url, headers=headers, json=body)

image_url = submission.json()['data'][0]['url']

print(image_url)

Skrip membuat panggilan API pembuatan gambar yang sinkron.

import requests
import time
import os

api_base = os.environ['AZURE_OPENAI_ENDPOINT'] # Enter your endpoint here
api_key = os.environ['AZURE_OPENAI_API_KEY']         # Enter your API key here

# Assign the API version (DALL-E is currently supported for the 2023-06-01-preview API version only)
api_version = '2023-06-01-preview'

# Define the prompt for the image generation
url = f"{api_base}openai/images/generations:submit?api-version={api_version}"
headers= { "api-key": api_key, "Content-Type": "application/json" }
body = {
    # Enter your prompt text here
    "prompt": "a multi-colored umbrella on the beach, disposable camera",  
    "size": "1024x1024",
    "n": 1
}
submission = requests.post(url, headers=headers, json=body)

# Call the API to generate the image and retrieve the response
operation_location = submission.headers['operation-location']
status = ""
while (status != "succeeded"):
    time.sleep(1)
    response = requests.get(operation_location, headers=headers)
    status = response.json()['status']
image_url = response.json()['result']['data'][0]['url']

print(image_url)

Skrip melakukan panggilan API pembuatan gambar dan kemudian mengulang hingga gambar yang dihasilkan siap.

Penting

Ingatlah untuk menghapus kunci dari kode Anda setelah selesai, dan jangan pernah memposting kunci Anda secara publik. Untuk produksi, gunakan cara yang aman dalam menyimpan dan mengakses info masuk Anda. Untuk informasi selengkapnya, lihat Azure Key Vault.

Jalankan aplikasi dengan python perintah:
```
python quickstart.py
```
Tunggu beberapa saat untuk mendapatkan respons.

Output

Output dari panggilan API pembuatan gambar yang berhasil terlihat seperti contoh berikut. Bidang url berisi URL tempat Anda dapat mengunduh gambar yang dihasilkan. URL tetap aktif selama 24 jam.

DALL-E 3
DALL-E 2 (pratinjau)

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

{
    "created": 1685130482,
    "expires": 1685216887,
    "id": "088e4742-89e8-4c38-9833-c294a47059a3",
    "result":
    {
        "data":
        [
            {
                "url": "<URL_to_generated_image>"
            }
        ]
    },
    "status": "succeeded"
}

API pembuatan gambar dilengkapi dengan filter moderasi konten. Jika layanan mengenali permintaan Anda sebagai konten berbahaya, maka layanan tidak menghasilkan gambar. Untuk informasi selengkapnya, lihat Pemfilteran konten. Untuk contoh respons kesalahan, lihat panduan cara penggunaan DALL-E.

Sistem mengembalikan status Failed operasi dan error.code nilai dalam pesan diatur ke contentFilter. Berikut contohnya:

DALL-E 3
DALL-E 2 (pratinjau)

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

{
   "created": 1589478378,
   "error": {
       "code": "contentFilter",
       "message": "Your task failed as a result of our safety system."
   },
   "id": "9484f239-9a05-41ba-997b-78252fec4b34",
   "status": "failed"
}

Ada kemungkinan juga bahwa gambar yang dihasilkan itu sendiri difilter. Dalam hal ini, pesan kesalahan diatur ke Generated image was filtered as a result of our safety system.. Berikut contohnya:

DALL-E 3
DALL-E 2 (pratinjau)

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

{
   "created": 1589478378,
   "expires": 1589478399,
   "id": "9484f239-9a05-41ba-997b-78252fec4b34",
   "lastActionDateTime": 1589478378,
   "data": [
       {
           "url": "<URL_TO_IMAGE>"
       },
       {
           "error": {
               "code": "contentFilter",
               "message": "Generated image was filtered as a result of our safety system."
           }
       }
   ],
   "status": "succeeded"
}

Membersihkan sumber daya

Jika Anda ingin membersihkan dan menghapus sumber daya Azure OpenAI, Anda dapat menghapus sumber daya atau grup sumber daya. Menghapus grup sumber daya juga menghapus sumber daya apa pun yang terkait dengannya.

Langkah berikutnya

Jelajahi API pembuatan gambar secara lebih mendalam dengan panduan cara KERJA DALL-E.
Coba contoh di repositori GitHub Sampel Azure OpenAI.
Lihat referensi API

Gunakan panduan ini untuk mulai menghasilkan gambar dengan Azure OpenAI SDK untuk Python.

Kode sumber pustaka | Paket | Sampel

Prasyarat

DALL-E 3
DALL-E 2 (pratinjau)

Langganan Azure. Buat akun gratis.
Akses yang diberikan ke DALL-E dalam langganan Azure yang diinginkan. Anda dapat mengajukan permohonan akses ke Layanan Azure OpenAI dengan melengkapi formulir di https://aka.ms/oai/access.
Python 3.8 atau versi yang lebih baru.
Sumber daya Azure OpenAI yang dibuat di EastUSwilayah , , AustraliaEastatau SwedenCentral .
Kemudian, Anda perlu menyebarkan dalle3 model dengan sumber daya Azure Anda. Untuk informasi selengkapnya, lihat Membuat sumber daya dan menyebarkan model dengan Azure OpenAI.

Langganan Azure. Buat akun gratis.
Akses yang diberikan ke DALL-E dalam langganan Azure yang diinginkan. Anda dapat mengajukan permohonan akses ke Layanan Azure OpenAI dengan melengkapi formulir di https://aka.ms/oai/access.
Python 3.8 atau versi yang lebih baru.
Sumber daya Azure OpenAI yang dibuat di wilayah tersebut EastUS . Untuk informasi selengkapnya, lihat Membuat sumber daya dan menyebarkan model dengan Azure OpenAI.

Catatan

Saat ini, Anda harus mengirimkan aplikasi untuk mengakses Layanan Azure OpenAI. Untuk mengajukan akses, lengkapi formulir di https://aka.ms/oai/access. Jika Anda memerlukan bantuan, buka masalah pada repositori ini untuk menghubungi Microsoft.

Siapkan

Mengambil kunci dan titik akhir

Agar berhasil memanggil API Azure OpenAI, Anda memerlukan informasi berikut tentang sumber daya Azure OpenAI Anda:

Variabel	Nama	Nilai
Endpoint	`api_base`	Nilai titik akhir terletak di bawah Kunci dan Titik Akhir untuk sumber daya Anda di portal Azure. Atau, Anda dapat menemukan nilai di Azure OpenAI Studio>Playground>Tampilan Kode. Contoh titik akhir adalah: `https://docs-test-001.openai.azure.com/`.
Kunci	`api_key`	Nilai kunci juga terletak di bawah Kunci dan Titik Akhir untuk sumber daya Anda di portal Azure. Azure menghasilkan dua kunci untuk sumber daya Anda. Anda dapat menggunakan salah satu nilai.

Buka sumber daya Anda di portal Azure. Pada panel navigasi, pilih Kunci dan Titik Akhir di bawah Manajemen Sumber Daya. Salin nilai Titik akhir dan nilai kunci akses. Anda dapat menggunakan nilai KEY 1 atau KEY 2 . Selalu miliki dua kunci untuk memungkinkan Anda memutar dan meregenerasi kunci dengan aman tanpa menyebabkan gangguan layanan.

Buat dan tetapkan variabel lingkungan persisten untuk kunci dan titik akhir Anda.

Variabel lingkungan

Buat dan tetapkan variabel lingkungan persisten untuk kunci dan titik akhir Anda.

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"

Menginstal Python SDK

Buka perintah dan telusuri folder proyek Anda. Instal OpenAI Python SDK dengan menggunakan perintah berikut:

DALL-E 3
DALL-E 2 (pratinjau)

pip install openai

Penting

Rilis terbaru pustaka OpenAI Python saat ini tidak mendukung DALL-E 2 saat digunakan dengan Azure OpenAI. Untuk mengakses DALL-E 2 dengan Azure OpenAI gunakan versi 0.28.1. Atau, ikuti panduan migrasi untuk menggunakan DALL-E 2 dengan OpenAI 1.x.

pip install openai==0.28.1

Instal pustaka berikut juga:

pip install requests
pip install pillow

Hasilkan gambar dengan DALL-E

Buat file python baru, quickstart.py. Buka file di editor atau IDE pilihan Anda.

Ganti konten quickstart.py dengan kode berikut.

DALL-E 3
DALL-E 2 (pratinjau)

from openai import AzureOpenAI
import os
import requests
from PIL import Image
import json

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

result = client.images.generate(
    model="dalle3", # the name of your DALL-E 3 deployment
    prompt="a close-up of a bear walking throughthe forest",
    n=1
)

json_response = json.loads(result.model_dump_json())

# 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')

# Retrieve the generated image
image_url = json_response["data"][0]["url"]  # extract image URL from response
generated_image = requests.get(image_url).content  # download the image
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()

Masukkan URL dan kunci titik akhir Anda di bidang yang sesuai.
Ubah nilai prompt menjadi teks pilihan Anda.
Ubah nilai model menjadi nama model DALL-E 3 anda yang disebarkan.

import openai
import os
import requests
from PIL import Image

# Get endpoint and key from environment variables
openai.api_base = os.environ['AZURE_OPENAI_ENDPOINT']
openai.api_key = os.environ['AZURE_OPENAI_API_KEY']     

# Assign the API version (DALL-E is currently supported for the 2023-06-01-preview API version only)
openai.api_version = '2023-06-01-preview'
openai.api_type = 'azure'

# Create an image by using the image generation API
generation_response = openai.Image.create(
    prompt='A painting of a dog',    # Enter your prompt text here
    size='1024x1024',
    n=2
)

# 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')

# Retrieve the generated image
image_url = generation_response["data"][0]["url"]  # extract image URL from response
generated_image = requests.get(image_url).content  # download the image
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()

Masukkan URL dan kunci titik akhir Anda di bidang yang sesuai.
Ubah nilai prompt menjadi teks pilihan Anda.

Penting

Ingatlah untuk menghapus kunci dari kode Anda setelah selesai, dan jangan pernah memposting kunci Anda secara publik. Untuk produksi, gunakan cara yang aman dalam menyimpan dan mengakses info masuk Anda. Untuk informasi selengkapnya, lihat Azure Key Vault.

Jalankan aplikasi dengan python perintah:

python quickstart.py

Tunggu beberapa saat untuk mendapatkan respons.

Output

Azure OpenAI menyimpan gambar output dalam file generated_image.png di direktori yang Anda tentukan. Skrip juga menampilkan gambar di penampil gambar default Anda.

API pembuatan gambar dilengkapi dengan filter moderasi konten. Jika layanan mengenali permintaan Anda sebagai konten berbahaya, maka layanan tidak menghasilkan gambar. Untuk informasi selengkapnya, lihat Pemfilteran konten.

Membersihkan sumber daya

Jika Anda ingin membersihkan dan menghapus sumber daya Azure OpenAI, Anda dapat menghapus sumber daya atau grup sumber daya. Menghapus grup sumber daya juga menghapus sumber daya apa pun yang terkait dengannya.

Langkah berikutnya

Jelajahi API pembuatan gambar secara lebih mendalam dengan panduan cara KERJA DALL-E.
Coba contoh di repositori GitHub Sampel Azure OpenAI.
Lihat referensi API

Gunakan panduan ini untuk mulai menghasilkan gambar dengan Azure OpenAI SDK untuk C#.

Paket kode | sumber pustaka (NuGet) | Sampel

Prasyarat

Langganan Azure - buat langganan gratis
Akses yang diberikan ke Azure OpenAI Service dalam langganan Azure yang diinginkan. Saat ini, akses ke layanan ini hanya diberikan oleh aplikasi. Anda dapat mengajukan permohonan akses ke Layanan Azure OpenAI dengan melengkapi formulir di https://aka.ms/oai/access.
.NET 7 SDK
Sumber daya Azure OpenAI dibuat di wilayah US Timur. Untuk informasi selengkapnya, lihat Membuat sumber daya dan menyebarkan model dengan Azure OpenAI.

Catatan

Saat ini, Anda harus mengirimkan aplikasi untuk mengakses Layanan Azure OpenAI. Untuk mengajukan akses, lengkapi formulir di https://aka.ms/oai/access. Jika Anda memerlukan bantuan, buka masalah pada repositori ini untuk menghubungi Microsoft.

Siapkan

Mengambil kunci dan titik akhir

Agar berhasil melakukan panggilan terhadap Azure OpenAI, Anda memerlukan titik akhir dan kunci.

Nama variabel	Nilai
`ENDPOINT`	Nilai ini dapat ditemukan di bagian Kunci & Titik Akhir saat memeriksa sumber daya Anda dari portal Microsoft Azure. Atau, Anda dapat menemukan nilainya di Azure OpenAI Studio>Playground>Tampilan Kode. Contoh titik akhir adalah: `https://docs-test-001.openai.azure.com/`.
`API-KEY`	Nilai ini dapat ditemukan di bagian Kunci & Titik Akhir saat memeriksa sumber daya Anda dari portal Microsoft Azure. Anda dapat menggunakan `KEY1` atau `KEY2`.

Buka sumber daya Anda di portal Azure. Bagian Kunci & Titik Akhir dapat ditemukan di bagian Manajemen Sumber Daya. Salin titik akhir dan kunci akses Anda karena keduanya diperlukan untuk mengautentikasi panggilan API Anda. Anda dapat menggunakan KEY1 atau KEY2. Selalu miliki dua kunci untuk memungkinkan Anda memutar dan meregenerasi kunci dengan aman tanpa menyebabkan gangguan layanan.

Variabel lingkungan

Buat dan tetapkan variabel lingkungan persisten untuk kunci dan titik akhir Anda.

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"

Buat aplikasi .NET Core baru

Di jendela konsol (seperti cmd, PowerShell, atau Bash), gunakan perintah dotnet new untuk membuat aplikasi konsol baru dengan nama azure-openai-quickstart. Perintah ini membuat proyek "Halo Dunia" sederhana dengan satu file sumber C#: Program.cs.

dotnet new console -n azure-openai-quickstart

Ubah direktori Anda ke folder aplikasi yang baru dibuat. Anda dapat membangun aplikasi dengan:

dotnet build

Output build tidak boleh berisi peringatan atau kesalahan.

...
Build succeeded.
 0 Warning(s)
 0 Error(s)
...

Menginstal OpenAI .NET SDK

Instal pustaka klien dengan:

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

Hasilkan gambar dengan DALL-E

Dari direktori proyek, buka file program.cs dan ganti konten dengan kode berikut:

using System;
using System.IO;
using System.Threading.Tasks;
using Azure.AI.OpenAI;

namespace Azure.AI.OpenAI.Tests.Samples
{
    public partial class GenerateImages
    {
        // add an async Main method:
        public static async Task Main(string[] args)
        {
            string endpoint = GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT");
            string key = GetEnvironmentVariable("AZURE_OPENAI_API_KEY");

            OpenAIClient client = new(new Uri(endpoint), new AzureKeyCredential(key));

            Response<ImageGenerations> imageGenerations = await client.GetImageGenerationsAsync(
                new ImageGenerationOptions()
                {
                    Prompt = "a happy monkey eating a banana, in watercolor",
                    Size = ImageSize.Size256x256,
                });

            // Image Generations responses provide URLs you can use to retrieve requested images
            Uri imageUri = imageGenerations.Value.Data[0].Url;
            
            // Print the image URI to console:
            Console.WriteLine(imageUri);
        }
    }
}

Bangun dan jalankan aplikasi dari direktori aplikasi Anda dengan perintah berikut:

dotnet build
dotnet run

Output

URL gambar yang dihasilkan dicetak ke konsol.

https://dalleproduse.blob.core.windows.net/private/images/552c5522-af4a-4877-a19c-400fac04a422/generated_00.png?se=2023-08-17T16%3A54%3A40Z&sig=XGCIx9r0WvWTJ0LL%2FJGymo2WYp4FDbSQNNrGRUnnUzI%3D&ske=2023-08-19T01%3A10%3A14Z&skoid=09ba021e-c417-441c-b203-c81e5dcd7b7f&sks=b&skt=2023-08-12T01%3A10%3A14Z&sktid=33e01921-4d64-4f8c-a055-5bdaffd5e33d&skv=2020-10-02&sp=r&spr=https&sr=b&sv=2020-10-02

Catatan

API pembuatan gambar dilengkapi dengan filter moderasi konten. Jika layanan mengenali permintaan Anda sebagai konten berbahaya, layanan tidak akan mengembalikan gambar yang dihasilkan. Untuk informasi selengkapnya, lihat artikel filter konten.

Membersihkan sumber daya

Jika Anda ingin membersihkan dan menghapus sumber daya Azure OpenAI, Anda dapat menghapus sumber daya. Sebelum menghapus sumber daya, Anda harus terlebih dahulu menghapus model yang disebarkan.

Langkah berikutnya

Jelajahi API pembuatan gambar secara lebih mendalam dengan panduan cara KERJA DALL-E.
Untuk contoh selengkapnya, lihat repositori GitHub Sampel Azure OpenAI.

Gunakan panduan ini untuk mulai menghasilkan gambar dengan Azure OpenAI SDK for Java.

Artefak kode | sumber pustaka (Maven) | Sampel

Prasyarat

Langganan Azure - buat langganan gratis
Akses yang diberikan ke layanan Azure OpenAI dalam langganan Azure yang diinginkan. Saat ini, akses ke layanan ini hanya diberikan oleh aplikasi. Anda dapat mengajukan permohonan akses ke Layanan Azure OpenAI dengan melengkapi formulir di https://aka.ms/oai/access.

Versi terbaru Java Development Kit (JDK)
Alat build Gradle, atau manajer dependensi lainnya.

Sumber daya Azure OpenAI dibuat di wilayah US Timur. Untuk informasi selengkapnya, lihat Membuat sumber daya dan menyebarkan model dengan Azure OpenAI.

Catatan

Saat ini, Anda harus mengirimkan aplikasi untuk mengakses Layanan Azure OpenAI. Untuk mengajukan akses, lengkapi formulir di https://aka.ms/oai/access. Jika Anda memerlukan bantuan, buka masalah pada repositori ini untuk menghubungi Microsoft.

Siapkan

Mengambil kunci dan titik akhir

Agar berhasil melakukan panggilan terhadap Azure OpenAI, Anda memerlukan titik akhir dan kunci.

Nama variabel	Nilai
`ENDPOINT`	Nilai ini dapat ditemukan di bagian Kunci & Titik Akhir saat memeriksa sumber daya Anda dari portal Microsoft Azure. Atau, Anda dapat menemukan nilainya di Azure OpenAI Studio>Playground>Tampilan Kode. Contoh titik akhir adalah: `https://docs-test-001.openai.azure.com/`.
`API-KEY`	Nilai ini dapat ditemukan di bagian Kunci & Titik Akhir saat memeriksa sumber daya Anda dari portal Microsoft Azure. Anda dapat menggunakan `KEY1` atau `KEY2`.

Buka sumber daya Anda di portal Azure. Bagian Kunci & Titik Akhir dapat ditemukan di bagian Manajemen Sumber Daya. Salin titik akhir dan kunci akses Anda karena keduanya diperlukan untuk mengautentikasi panggilan API Anda. Anda dapat menggunakan KEY1 atau KEY2. Selalu miliki dua kunci untuk memungkinkan Anda memutar dan meregenerasi kunci dengan aman tanpa menyebabkan gangguan layanan.

Variabel lingkungan

Buat dan tetapkan variabel lingkungan persisten untuk kunci dan titik akhir Anda.

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"

Membuat aplikasi Java baru

Buat proyek Gradle baru.

Di jendela konsol (seperti cmd, PowerShell, atau Bash), buat direktori baru untuk aplikasi Anda, dan buka direktori tersebut.

mkdir myapp && cd myapp

Jalankan perintah gradle init dari direktori yang berfungsi. Perintah ini akan membuat file build penting untuk Gradle, termasuk build.gradle.kts yang digunakan saat runtime bahasa umum untuk membuat dan mengonfigurasi aplikasi Anda.

gradle init --type basic

Saat diminta untuk memilih DSL, pilih Kotlin.

Memasang Java SDK

Mulai cepat ini menggunakan pengelola dependensi Gradle. Anda dapat menemukan pustaka klien dan informasi untuk pengelola dependensi lain di Repositori Pusat Maven.

Temukan build.gradle.kts lalu buka dengan IDE atau editor teks pilihan Anda. Lalu, salin dalam konfigurasi build berikut. Konfigurasi ini mendefinisikan proyek sebagai aplikasi Java yang titik masuknya adalah kelas OpenAIQuickstart. Ini mengimpor pustaka Azure AI Vision.

plugins {
    java
    application
}
application { 
    mainClass.set("OpenAIQuickstart")
}
repositories {
    mavenCentral()
}
dependencies {
    implementation(group = "com.azure", name = "azure-ai-openai", version = "1.0.0-beta.3")
    implementation("org.slf4j:slf4j-simple:1.7.9")
}

Hasilkan gambar dengan DALL-E

Buat file Java.

Dari direktori kerja Anda, jalankan perintah berikut ini untuk membuat folder sumber proyek:
```
mkdir -p src/main/java
```
Navigasikan ke folder baru dan buat file yang disebut OpenAIQuickstart.java.

Buka OpenAIQuickstart.java di editor atau IDE pilihan Anda dan tempelkan kode berikut.

import com.azure.ai.openai.OpenAIAsyncClient;
import com.azure.ai.openai.OpenAIClientBuilder;
import com.azure.ai.openai.models.ImageGenerationOptions;
import com.azure.ai.openai.models.ImageLocation;
import com.azure.core.credential.AzureKeyCredential;
import com.azure.core.models.ResponseError;

import java.util.concurrent.TimeUnit;

/**
 * Sample demonstrates how to get the images for a given prompt.
 */
public class OpenAIQuickstart {

    /**
     * Runs the sample algorithm and demonstrates how to get the images for a given prompt.
     *
     * @param args Unused. Arguments to the program.
     */
    public static void main(String[] args) throws InterruptedException {

        // Get key and endpoint from environment variables:
        String azureOpenaiKey = System.getenv("AZURE_OPENAI_API_KEY");
        String endpoint = System.getenv("AZURE_OPENAI_ENDPOINT");

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

        ImageGenerationOptions imageGenerationOptions = new ImageGenerationOptions(
            "A drawing of the Seattle skyline in the style of Van Gogh");
        client.getImages(imageGenerationOptions).subscribe(
            images -> {
                for (ImageLocation imageLocation : images.getData()) {
                    ResponseError error = imageLocation.getError();
                    if (error != null) {
                        System.out.printf("Image generation operation failed. Error code: %s, error message: %s.%n",
                            error.getCode(), error.getMessage());
                    } else {
                        System.out.printf(
                            "Image location URL that provides temporary access to download the generated image is %s.%n",
                            imageLocation.getUrl());
                    }
                }
            },
            error -> System.err.println("There was an error getting images." + error),
            () -> System.out.println("Completed getImages."));

        // The .subscribe() creation and assignment is not a blocking call. For the purpose of this example, we sleep
        // the thread so the program does not end before the send operation is complete. Using .block() instead of
        // .subscribe() will turn this into a synchronous call.
        TimeUnit.SECONDS.sleep(10);
    }
}

Kembali ke folder akar proyek, dan bangun aplikasi tersebut dengan:
```
gradle build
```
Kemudian, jalankan dengan perintah gradle run:
```
gradle run
```

Output

URL gambar yang dihasilkan dicetak ke konsol.

Image location URL that provides temporary access to download the generated image is https://dalleproduse.blob.core.windows.net/private/images/d2ea917f-8802-4ad6-8ef6-3fb7a15c8482/generated_00.png?se=2023-08-25T23%3A11%3A28Z&sig=%2BKa5Mkb9U88DfvxoBpyAjamYRzwb7aVCEucM6XJC3wQ%3D&ske=2023-08-31T15%3A27%3A47Z&skoid=09ba021e-c417-441c-b203-c81e5dcd7b7f&sks=b&skt=2023-08-24T15%3A27%3A47Z&sktid=33e01921-4d64-4f8c-a055-5bdaffd5e33d&skv=2020-10-02&sp=r&spr=https&sr=b&sv=2020-10-02.
Completed getImages.

Catatan

API pembuatan gambar dilengkapi dengan filter moderasi konten. Jika layanan mengenali permintaan Anda sebagai konten berbahaya, layanan tidak akan mengembalikan gambar yang dihasilkan. Untuk informasi selengkapnya, lihat artikel filter konten.

Membersihkan sumber daya

Jika Anda ingin membersihkan dan menghapus sumber daya Azure OpenAI, Anda dapat menghapus sumber daya. Sebelum menghapus sumber daya, Anda harus terlebih dahulu menghapus model yang disebarkan.

Langkah berikutnya

Jelajahi API pembuatan gambar secara lebih mendalam dengan panduan cara KERJA DALL-E.
Untuk contoh selengkapnya, lihat repositori GitHub Sampel Azure OpenAI

Gunakan panduan ini untuk mulai menghasilkan gambar dengan Azure OpenAI SDK for JavaScript.

Paket kode | sumber pustaka (npm) | Sampel

Prasyarat

Langganan Azure - buat langganan gratis
Akses yang diberikan ke layanan Azure OpenAI dalam langganan Azure yang diinginkan. Saat ini, akses ke layanan ini hanya diberikan oleh aplikasi. Anda dapat mengajukan permohonan akses ke Layanan Azure OpenAI dengan melengkapi formulir di https://aka.ms/oai/access.
Versi LTS dari Node.js
Sumber daya Azure OpenAI dibuat di wilayah US Timur. Untuk informasi selengkapnya, lihat Membuat sumber daya dan menyebarkan model dengan Azure OpenAI.

Catatan

Saat ini, Anda harus mengirimkan aplikasi untuk mengakses Layanan Azure OpenAI. Untuk mengajukan akses, lengkapi formulir ini. Jika Anda memerlukan bantuan, buka masalah pada repositori ini untuk menghubungi Microsoft.

Siapkan

Mengambil kunci dan titik akhir

Agar berhasil melakukan panggilan terhadap Azure OpenAI, Anda memerlukan titik akhir dan kunci.

Nama variabel	Nilai
`ENDPOINT`	Nilai ini dapat ditemukan di bagian Kunci & Titik Akhir saat memeriksa sumber daya Anda dari portal Microsoft Azure. Atau, Anda dapat menemukan nilainya di Azure OpenAI Studio>Playground>Tampilan Kode. Contoh titik akhir adalah: `https://docs-test-001.openai.azure.com/`.
`API-KEY`	Nilai ini dapat ditemukan di bagian Kunci & Titik Akhir saat memeriksa sumber daya Anda dari portal Microsoft Azure. Anda dapat menggunakan `KEY1` atau `KEY2`.

Buka sumber daya Anda di portal Azure. Bagian Kunci & Titik Akhir dapat ditemukan di bagian Manajemen Sumber Daya. Salin titik akhir dan kunci akses Anda karena keduanya diperlukan untuk mengautentikasi panggilan API Anda. Anda dapat menggunakan KEY1 atau KEY2. Selalu miliki dua kunci untuk memungkinkan Anda memutar dan meregenerasi kunci dengan aman tanpa menyebabkan gangguan layanan.

Variabel lingkungan

Buat dan tetapkan variabel lingkungan persisten untuk kunci dan titik akhir Anda.

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"

Membuat aplikasi Node

Di jendela konsol (seperti cmd, PowerShell, atau Bash), buat direktori baru untuk aplikasi Anda, dan buka direktori tersebut. Kemudian jalankan npm init perintah untuk membuat aplikasi simpul dengan file package.json .

npm init

Memasang pustaka klien

Instal pustaka klien Azure OpenAI untuk JavaScript dengan npm:

npm install @azure/openai

File package.json aplikasi Anda akan diperbarui dengan dependensi.

Hasilkan gambar dengan DALL-E

Buat file baru bernama ImageGeneration.js dan buka di editor kode pilihan Anda. Salin kode berikut ke dalam file ImageGeneration.js :

const { OpenAIClient, AzureKeyCredential } = require("@azure/openai");

// You will need to set these environment variables or edit the following values
const endpoint = process.env["AZURE_OPENAI_ENDPOINT"] ;
const azureApiKey = process.env["AZURE_OPENAI_API_KEY"] ;

// The prompt to generate images from
const prompt = "a monkey eating a banana";
const size = "256x256";

// The number of images to generate
const n = 2;

async function main() {
    console.log("== Batch Image Generation ==");
  
    const client = new OpenAIClient(endpoint, new AzureKeyCredential(azureApiKey));
    const deploymentName = "dall-e";
    const results = await client.getImages(deploymentName, prompt, { n, size });
  
    for (const image of results.data) {
      console.log(`Image generation result URL: ${image.url}`);
    }
    //console.log(`Image generation result URL: ${results.result.status}`);
}

main().catch((err) => {
console.error("The sample encountered an error:", err);
});

Menjalankan skrip dengan menjalankan perintah berikut:

node _ImageGeneration.js

Output

URL gambar yang dihasilkan dicetak ke konsol.

== Batch Image Generation ==
Image generation result URL: https://dalleproduse.blob.core.windows.net/private/images/5e7536a9-a0b5-4260-8769-2d54106f2913/generated_00.png?se=2023-08-29T19%3A12%3A57Z&sig=655GkWajOZ9ALjFykZF%2FBMZRPQALRhf4UPDImWCQoGI%3D&ske=2023-09-02T18%3A53%3A23Z&skoid=09ba021e-c417-441c-b203-c81e5dcd7b7f&sks=b&skt=2023-08-26T18%3A53%3A23Z&sktid=33e01921-4d64-4f8c-a055-5bdaffd5e33d&skv=2020-10-02&sp=r&spr=https&sr=b&sv=2020-10-02
Image generation result URL: https://dalleproduse.blob.core.windows.net/private/images/5e7536a9-a0b5-4260-8769-2d54106f2913/generated_01.png?se=2023-08-29T19%3A12%3A57Z&sig=B24ymPLSZ3HfG23uojOD9VlRFGxjvgcNmvFo4yPUbEc%3D&ske=2023-09-02T18%3A53%3A23Z&skoid=09ba021e-c417-441c-b203-c81e5dcd7b7f&sks=b&skt=2023-08-26T18%3A53%3A23Z&sktid=33e01921-4d64-4f8c-a055-5bdaffd5e33d&skv=2020-10-02&sp=r&spr=https&sr=b&sv=2020-10-02

Catatan

API pembuatan gambar dilengkapi dengan filter moderasi konten. Jika layanan mengenali permintaan Anda sebagai konten berbahaya, layanan tidak akan mengembalikan gambar yang dihasilkan. Untuk informasi selengkapnya, lihat artikel filter konten.

Membersihkan sumber daya

Jika Anda ingin membersihkan dan menghapus sumber daya Azure OpenAI, Anda dapat menghapus sumber daya. Sebelum menghapus sumber daya, Anda harus terlebih dahulu menghapus model yang disebarkan.

Langkah berikutnya

Jelajahi API pembuatan gambar secara lebih mendalam dengan panduan cara KERJA DALL-E.
Untuk contoh selengkapnya, lihat repositori GitHub Sampel Azure OpenAI.

Gunakan panduan ini untuk mulai menghasilkan gambar dengan Azure OpenAI SDK for Go.

Kode sumber pustaka | Paket | Sampel

Prasyarat

Langganan Azure - buat langganan gratis
Akses yang diberikan ke DALL-E dalam langganan Azure yang diinginkan Saat ini, akses ke layanan ini hanya diberikan oleh aplikasi. Anda dapat mengajukan permohonan akses ke Azure OpenAI dengan melengkapi formulir di https://aka.ms/oai/access. Pelanggan lama Azure OpenAI perlu mengajukan ulang formulir untuk mendapatkan akses ke DALL-E. Buka masalah pada repositori ini untuk menghubungi kami jika Anda mengalami masalah.

Go 1.8+

Sumber daya Azure OpenAI dibuat di wilayah US Timur. Untuk informasi selengkapnya, lihat Membuat sumber daya dan menyebarkan model dengan Azure OpenAI.

Catatan

Saat ini, Anda harus mengirimkan aplikasi untuk mengakses Layanan Azure OpenAI. Untuk mengajukan akses, lengkapi formulir di https://aka.ms/oai/access. Jika Anda memerlukan bantuan, buka masalah pada repositori ini untuk menghubungi Microsoft.

Siapkan

Mengambil kunci dan titik akhir

Agar berhasil melakukan panggilan terhadap Azure OpenAI, Anda memerlukan titik akhir dan kunci.

Nama variabel	Nilai
`ENDPOINT`	Nilai ini dapat ditemukan di bagian Kunci & Titik Akhir saat memeriksa sumber daya Anda dari portal Microsoft Azure. Atau, Anda dapat menemukan nilainya di Azure OpenAI Studio>Playground>Tampilan Kode. Contoh titik akhir adalah: `https://docs-test-001.openai.azure.com/`.
`API-KEY`	Nilai ini dapat ditemukan di bagian Kunci & Titik Akhir saat memeriksa sumber daya Anda dari portal Microsoft Azure. Anda dapat menggunakan `KEY1` atau `KEY2`.

Buka sumber daya Anda di portal Azure. Bagian Kunci & Titik Akhir dapat ditemukan di bagian Manajemen Sumber Daya. Salin titik akhir dan kunci akses Anda karena keduanya diperlukan untuk mengautentikasi panggilan API Anda. Anda dapat menggunakan KEY1 atau KEY2. Selalu miliki dua kunci untuk memungkinkan Anda memutar dan meregenerasi kunci dengan aman tanpa menyebabkan gangguan layanan.

Variabel lingkungan

Buat dan tetapkan variabel lingkungan persisten untuk kunci dan titik akhir Anda.

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"

Membuat aplikasi Go baru

Buka perintah dan navigasikan ke folder proyek Anda. Buat file baru sample.go.

Menginstal Go SDK

Instal OpenAI Go SDK menggunakan perintah berikut:

go get github.com/Azure/azure-sdk-for-go/sdk/ai/azopenai@latest

Atau, jika Anda menggunakan dep, dalam eksekusi repositori Anda:

dep ensure -add github.com/Azure/azure-sdk-for-go/sdk/ai/azopenai

Hasilkan gambar dengan DALL-E

Buka sample.go di editor kode pilihan Anda.

Tambahkan kode berikut ke skrip Anda:

package main

import (
	"context"
	"fmt"
	"net/http"
	"os"

	"github.com/Azure/azure-sdk-for-go/sdk/ai/azopenai"
	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
)

func main() {
	azureOpenAIKey := os.Getenv("AZURE_OPENAI_API_KEY")

	// Ex: "https://<your-azure-openai-host>.openai.azure.com"
	azureOpenAIEndpoint := os.Getenv("AZURE_OPENAI_ENDPOINT")

	if azureOpenAIKey == "" || azureOpenAIEndpoint == "" {
		fmt.Fprintf(os.Stderr, "Skipping example, environment variables missing\n")
		return
	}

	keyCredential, err := azopenai.NewKeyCredential(azureOpenAIKey)

	if err != nil {
		// handle error
	}

	client, err := azopenai.NewClientWithKeyCredential(azureOpenAIEndpoint, keyCredential, nil)

	if err != nil {
		// handle error
	}

	resp, err := client.CreateImage(context.TODO(), azopenai.ImageGenerationOptions{
		Prompt:         to.Ptr("a painting of a cat in the style of Dali"),
		ResponseFormat: to.Ptr(azopenai.ImageGenerationResponseFormatURL),
	}, nil)

	if err != nil {
		// handle error
	}

	for _, generatedImage := range resp.Data {
		// the underlying type for the generatedImage is dictated by the value of
		// ImageGenerationOptions.ResponseFormat. In this example we used `azopenai.ImageGenerationResponseFormatURL`,
		// so the underlying type will be ImageLocation.

		resp, err := http.Head(*generatedImage.URL)

		if err != nil {
			// handle error
		}

		fmt.Fprintf(os.Stderr, "Image generated, HEAD request on URL returned %d\nImage URL: %s\n", resp.StatusCode, *generatedImage.URL)
	}
}

Jalankan skrip menggunakan go run perintah :

go run sample.go

Output

URL gambar yang dihasilkan dicetak ke konsol.

Image generated, HEAD request on URL returned 200
Image URL: https://dalleproduse.blob.core.windows.net/private/images/d7b28a5c-ca32-4792-8c2a-6a5d8d8e5e45/generated_00.png?se=2023-08-29T17%3A05%3A37Z&sig=loqntaPypYVr9VTT5vpbsjsCz31g1GsdoQi0smbGkks%3D&ske=2023-09-02T18%3A53%3A23Z&skoid=09ba021e-c417-441c-b203-c81e5dcd7b7f&sks=b&skt=2023-08-26T18%3A53%3A23Z&sktid=33e01921-4d64-4f8c-a055-5bdaffd5e33d&skv=2020-10-02&sp=r&spr=https&sr=b&sv=2020-10-02

Catatan

API pembuatan gambar dilengkapi dengan filter moderasi konten. Jika layanan mengenali permintaan Anda sebagai konten berbahaya, layanan tidak akan mengembalikan gambar yang dihasilkan. Untuk informasi selengkapnya, lihat artikel filter konten.

Membersihkan sumber daya

Jika Anda ingin membersihkan dan menghapus sumber daya Azure OpenAI, Anda dapat menghapus sumber daya atau grup sumber daya. Menghapus grup sumber daya juga menghapus sumber daya apa pun yang terkait dengannya.

Langkah berikutnya

Jelajahi API pembuatan gambar secara lebih mendalam dengan panduan cara KERJA DALL-E.
Untuk contoh selengkapnya, lihat repositori GitHub Sampel Azure OpenAI.

Gunakan panduan ini untuk mulai memanggil API pembuatan gambar Azure OpenAI Service dengan menggunakan PowerShell.

Catatan

API pembuatan gambar membuat gambar dari perintah teks. Ini tidak mengedit gambar yang ada atau membuat variasi.

Prasyarat

Langganan Azure. Buat akun gratis.
Akses yang diberikan ke DALL-E dalam langganan Azure yang diinginkan.
Untuk tugas ini, versi terbaru PowerShell 7 direkomendasikan karena contoh menggunakan fitur baru tidak tersedia di Windows PowerShell 5.1.
Sumber daya Azure OpenAI dibuat di wilayah US Timur. Untuk informasi selengkapnya, lihat Membuat sumber daya dan menyebarkan model dengan Azure OpenAI.

Catatan

Saat ini, Anda harus mengirimkan aplikasi untuk mengakses Layanan Azure OpenAI. Untuk mengajukan akses, lengkapi formulir ini. Jika Anda memerlukan bantuan, buka masalah pada repositori ini untuk menghubungi Microsoft.

Siapkan

Mengambil kunci dan titik akhir

Agar berhasil melakukan panggilan terhadap Azure OpenAI, Anda memerlukan titik akhir dan kunci.

Nama variabel	Nilai
`ENDPOINT`	Nilai ini dapat ditemukan di bagian Kunci & Titik Akhir saat memeriksa sumber daya Anda dari portal Microsoft Azure. Atau, Anda dapat menemukan nilainya di Azure OpenAI Studio>Playground>Tampilan Kode. Contoh titik akhir adalah: `https://docs-test-001.openai.azure.com/`.
`API-KEY`	Nilai ini dapat ditemukan di bagian Kunci & Titik Akhir saat memeriksa sumber daya Anda dari portal Microsoft Azure. Anda dapat menggunakan `KEY1` atau `KEY2`.

Buka sumber daya Anda di portal Azure. Bagian Kunci & Titik Akhir dapat ditemukan di bagian Manajemen Sumber Daya. Salin titik akhir dan kunci akses Anda karena keduanya diperlukan untuk mengautentikasi panggilan API Anda. Anda dapat menggunakan KEY1 atau KEY2. Selalu miliki dua kunci untuk memungkinkan Anda memutar dan meregenerasi kunci dengan aman tanpa menyebabkan gangguan layanan.

Variabel lingkungan

Buat dan tetapkan variabel lingkungan persisten untuk kunci dan titik akhir Anda.

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"

Aku mengalami masalah dengan penyiapan.

Membuat skrip PowerShell baru

Buat file PowerShell baru bernama quickstart.ps1. Buka file baru di editor atau IDE pilihan Anda.

Ganti konten quickstart.ps1 dengan kode berikut. Masukkan URL dan kunci titik akhir Anda di bidang yang sesuai. Ubah nilai prompt menjadi teks pilihan Anda.

# Azure OpenAI metadata variables
$openai = @{
  api_key     = $Env:AZURE_OPENAI_API_KEY
  api_base    = $Env:AZURE_OPENAI_ENDPOINT # your endpoint should look like the following https://YOUR_RESOURCE_NAME.openai.azure.com/
  api_version = '2023-06-01-preview' # this may change in the future
}

# Text to describe image
$prompt = 'A painting of a dog'

# Header for authentication
$headers = [ordered]@{
  'api-key' = $openai.api_key
}

# Adjust these values to fine-tune completions
$body = [ordered]@{
   prompt = $prompt
   size   = '1024x1024'
   n      = 1
} | ConvertTo-Json

 # Call the API to generate the image and retrieve the response
$url = "$($openai.api_base)/openai/images/generations:submit?api-version=$($openai.api_version)"

$submission = Invoke-RestMethod -Uri $url -Headers $headers -Body $body -Method Post -ContentType 'application/json' -ResponseHeadersVariable submissionHeaders

 $operation_location = $submissionHeaders['operation-location'][0]
 $status = ''
 while ($status -ne 'succeeded') {
     Start-Sleep -Seconds 1
     $response = Invoke-RestMethod -Uri $operation_location -Headers $headers
     $status   = $response.status
 }

# 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'

# Retrieve the generated image
$image_url = $response.result.data[0].url  # extract image URL from response
$generated_image = Invoke-WebRequest -Uri $image_url -OutFile $image_path  # download the image
return $image_path

Penting

Untuk produksi, gunakan cara aman untuk menyimpan dan mengakses kredensial Anda seperti Manajemen Rahasia PowerShell dengan Azure Key Vault. Untuk informasi selengkapnya tentang keamanan kredensial, lihat artikel keamanan layanan Azure AI.

Jalankan skrip menggunakan PowerShell:
```
./quickstart.ps1
```
Skrip mengulang hingga gambar yang dihasilkan siap.

Output

PowerShell meminta gambar dari Azure OpenAI dan menyimpan gambar output dalam file generated_image.png di direktori yang Anda tentukan. Untuk kenyamanan, jalur lengkap untuk file dikembalikan di akhir skrip.

API pembuatan gambar dilengkapi dengan filter moderasi konten. Jika layanan mengenali permintaan Anda sebagai konten berbahaya, maka layanan tidak menghasilkan gambar. Untuk informasi selengkapnya, lihat Pemfilteran konten.

Membersihkan sumber daya

Jika Anda ingin membersihkan dan menghapus sumber daya Azure OpenAI, Anda dapat menghapus sumber daya atau grup sumber daya. Menghapus grup sumber daya juga menghapus sumber daya apa pun yang terkait dengannya.

Langkah berikutnya

Jelajahi API pembuatan gambar secara lebih mendalam dengan panduan cara KERJA DALL-E.

Coba contoh di repositori GitHub Sampel Azure OpenAI.

Bagikan melalui

Prasyarat

Buka Azure OpenAI Studio

Mencoba pembuatan gambar

Membersihkan sumber daya

Langkah berikutnya

Prasyarat

Siapkan

Mengambil kunci dan titik akhir

Variabel lingkungan

Membuat aplikasi Python baru

Output

Membersihkan sumber daya

Langkah berikutnya

Prasyarat

Siapkan

Mengambil kunci dan titik akhir

Variabel lingkungan

Menginstal Python SDK

Hasilkan gambar dengan DALL-E

Output

Membersihkan sumber daya

Langkah berikutnya

Prasyarat

Siapkan

Mengambil kunci dan titik akhir

Variabel lingkungan

Buat aplikasi .NET Core baru

Menginstal OpenAI .NET SDK

Hasilkan gambar dengan DALL-E

Output

Membersihkan sumber daya

Langkah berikutnya

Prasyarat

Siapkan

Mengambil kunci dan titik akhir

Variabel lingkungan

Membuat aplikasi Java baru

Memasang Java SDK

Hasilkan gambar dengan DALL-E

Output

Membersihkan sumber daya

Langkah berikutnya

Prasyarat

Siapkan

Mengambil kunci dan titik akhir

Variabel lingkungan

Membuat aplikasi Node

Memasang pustaka klien

Hasilkan gambar dengan DALL-E

Output

Membersihkan sumber daya

Langkah berikutnya

Prasyarat

Siapkan

Mengambil kunci dan titik akhir

Variabel lingkungan

Membuat aplikasi Go baru

Menginstal Go SDK

Hasilkan gambar dengan DALL-E

Output

Membersihkan sumber daya

Langkah berikutnya

Prasyarat

Siapkan

Mengambil kunci dan titik akhir

Variabel lingkungan

Membuat skrip PowerShell baru

Output

Membersihkan sumber daya

Langkah berikutnya

Saran dan Komentar

Saran dan Komentar

Sumber Daya Tambahan: