Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Model pembuatan gambar OpenAI merender gambar berdasarkan perintah teks yang disediakan pengguna dan gambar yang disediakan secara opsional. Panduan ini menunjukkan cara menggunakan model pembuatan gambar dan mengonfigurasi opsinya melalui panggilan REST API.
Prasyarat
- Sebuah langganan Azure. Anda dapat membuatnya secara gratis.
- Sumber daya Azure OpenAI dibuat di wilayah yang didukung. Lihat Ketersediaan wilayah.
- Sebarkan model
dall-e-3
ataugpt-image-1
dengan sumber daya Azure OpenAI Anda. Untuk informasi selengkapnya tentang penyebaran, lihat Membuat sumber daya dan menyebarkan model dengan Azure OpenAI.- GPT-image-1 adalah model yang lebih baru dan memiliki sejumlah peningkatan atas DALL-E 3. Ini tersedia dalam akses terbatas: ajukan akses dengan formulir ini.
Memanggil API Pembuatan Gambar
Perintah berikut menunjukkan cara paling dasar untuk menggunakan model gambar dengan kode. Jika ini pertama kalinya Anda menggunakan model ini secara terprogram, sebaiknya mulai dengan mulai cepat.
Kirim permintaan POST ke:
https://<your_resource_name>.openai.azure.com/openai/deployments/<your_deployment_name>/images/generations?api-version=<api_version>
URL:
Ganti nilai berikut:
-
<your_resource_name>
adalah nama sumber daya Azure OpenAI Anda. -
<your_deployment_name>
adalah nama untuk model penyebaran DALL-E 3 atau GPT-image-1 Anda. -
<api_version>
adalah versi API yang ingin Anda gunakan. Contohnya,2025-04-01-preview
.
Header yang diperlukan:
-
Content-Type
:application/json
-
api-key
:<your_API_key>
Badan:
Berikut ini adalah isi permintaan sampel. Anda menentukan sejumlah opsi, yang ditentukan di bagian selanjutnya.
{
"prompt": "A multi-colored umbrella on the beach, disposable camera",
"model": "gpt-image-1",
"size": "1024x1024",
"n": 1,
"quality": "high"
}
Petunjuk / Saran
Untuk biaya token pembuatan gambar, lihat Token gambar.
Keluaran
Respons 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.
{
"created": 1698116662,
"data": [
{
"url": "<URL_to_generated_image>",
"revised_prompt": "<prompt_that_was_used>"
}
]
}
Penolakan panggilan API
Perintah dan gambar difilter berdasarkan kebijakan konten kami, mengembalikan kesalahan saat perintah atau gambar ditandai.
Jika perintah Anda ditandai, error.code
nilai dalam pesan diatur ke contentFilter
. Berikut adalah sebuah contoh:
{
"created": 1698435368,
"error":
{
"code": "contentFilter",
"message": "Your task failed as a result of our safety system."
}
}
Ada kemungkinan juga bahwa gambar yang dihasilkan itu sendiri difilter. Dalam hal ini, pesan kesalahan diatur ke Gambar yang Dihasilkan difilter sebagai hasil dari sistem keamanan kami. Berikut adalah sebuah contoh:
{
"created": 1698435368,
"error":
{
"code": "contentFilter",
"message": "Generated image was filtered as a result of our safety system."
}
}
Menulis perintah teks ke gambar
Perintah Anda harus menjelaskan konten yang ingin Anda lihat dalam gambar, dan gaya visual gambar.
Saat Anda menulis perintah, pertimbangkan bahwa API 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.
Petunjuk / Saran
Untuk melihat secara menyeluruh bagaimana Anda dapat mengubah perintah teks Anda untuk menghasilkan berbagai jenis gambar, lihat panduan rekayasa permintaan gambar.
Tentukan opsi API
Parameter isi API berikut tersedia untuk model pembuatan gambar.
Ukuran
Tentukan ukuran gambar yang dihasilkan. Harus salah satu dari 1024x1024
, 1024x1536
, atau 1536x1024
untuk model GPT-image-1. Gambar persegi lebih cepat untuk dihasilkan.
Kualitas
Ada tiga opsi untuk kualitas gambar: low
, , medium
dan high
. Gambar berkualitas lebih rendah dapat dihasilkan lebih cepat.
Nilai defaultnya adalah high
.
Angka
Anda dapat menghasilkan antara satu dan 10 gambar dalam satu panggilan API. Nilai defaultnya adalah 1
.
ID Pengguna
Gunakan parameter pengguna untuk menentukan pengidentifikasi unik untuk pengguna yang membuat permintaan. Ini berguna untuk melacak dan memantau pola penggunaan. Nilainya bisa berupa string apa pun, seperti ID pengguna atau alamat email.
Format keluaran
Gunakan parameter output_format untuk menentukan format gambar yang dihasilkan. Format yang didukung adalah PNG
dan JPEG
. Defaultnya adalah PNG
.
Nota
Gambar WEBP tidak didukung dalam layanan Azure OpenAI di model Azure AI Foundry.
Kompresi
Gunakan parameter output_compression untuk menentukan tingkat kompresi untuk gambar yang dihasilkan. Masukkan bilangan bulat antara 0
dan 100
, di mana 0
tidak ada pemadatan dan 100
merupakan pemadatan maksimum. Defaultnya adalah 100
.
Memanggil API Edit Gambar
IMAGE Edit API memungkinkan Anda memodifikasi gambar yang ada berdasarkan perintah teks yang Anda berikan. Panggilan API mirip dengan panggilan API pembuatan gambar, tetapi Anda juga perlu memberikan gambar input.
Penting
Gambar input harus berukuran kurang dari 20 MB dan harus berupa file PNG atau JPG.
Kirim permintaan POST ke:
https://<your_resource_name>.openai.azure.com/openai/deployments/<your_deployment_name>/images/edits?api-version=<api_version>
URL:
Ganti nilai berikut:
-
<your_resource_name>
adalah nama sumber daya Azure OpenAI Anda. -
<your_deployment_name>
adalah nama untuk model penyebaran DALL-E 3 atau GPT-image-1 Anda. -
<api_version>
adalah versi API yang ingin Anda gunakan. Contohnya,2025-04-01-preview
.
Header yang diperlukan:
-
Content-Type
:multipart/form-data
-
api-key
:<your_API_key>
Badan:
Berikut ini adalah isi permintaan sampel. Anda menentukan sejumlah opsi, yang ditentukan di bagian selanjutnya.
Penting
IMAGE Edit API mengambil data multipart/form, bukan data JSON. Contoh di bawah ini menunjukkan contoh data formulir yang akan dilampirkan ke permintaan cURL.
-F "image[]=@beach.png" \
-F 'prompt=Add a beach ball in the center' \
-F "model=gpt-image-1" \
-F "size=1024x1024" \
-F "n=1" \
-F "quality=high"
Keluaran
Respons dari panggilan API pengeditan gambar yang berhasil terlihat seperti contoh berikut. Bidang b64_json
berisi data gambar output.
{
"created": 1698116662,
"data": [
{
"b64_json": "<base64 image data>",
"revised_prompt": "<prompt_that_was_used>"
}
]
}
Tentukan opsi API
Parameter isi API berikut tersedia untuk model pengeditan gambar, selain yang tersedia untuk model pembuatan gambar.
Gambar
Nilai gambar menunjukkan file gambar yang ingin Anda edit.
Masker
Parameter masker adalah jenis yang sama dengan parameter input gambar utama. Ini menentukan area gambar yang ingin Anda diedit oleh model, dengan menggunakan piksel yang sepenuhnya transparan (alfa sebesar nol) di area tersebut. Masker harus berupa file PNG dan memiliki dimensi yang sama dengan gambar input.