Bagikan melalui

Cara menggunakan model pembuatan gambar Azure OpenAI

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

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, , mediumdan 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.

Konten terkait