Bagikan melalui

Cara bekerja dengan model DALL-E

  • Artikel

Model DALL-E OpenAI menghasilkan gambar berdasarkan perintah teks yang disediakan pengguna. Panduan ini menunjukkan cara menggunakan model DALL-E dan mengonfigurasi opsinya melalui panggilan REST API.

Prasyarat

Memanggil API Pembuatan Gambar

Perintah berikut menunjukkan cara paling dasar untuk menggunakan DALL-E dengan kode. Jika ini pertama kalinya Anda menggunakan model ini secara terprogram, sebaiknya mulai dengan mulai cepat DALL-E.

Kirim permintaan POST ke:

https://<your_resource_name>.openai.azure.com/openai/deployments/<your_deployment_name>/images/generations?api-version=<api_version>

Ganti tempat penampung berikut:

  • <your_resource_name> adalah nama sumber daya Azure OpenAI Anda.
  • <your_deployment_name> adalah nama penyebaran model DALL-E 3 Anda.
  • <api_version> adalah versi API yang ingin Anda gunakan. Contohnya,2024-02-01.

Header yang diperlukan:

  • Content-Type: application/json
  • api-key: <your_API_key>

Isi:

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",
    "size": "1024x1024", 
    "n": 1,
    "quality": "hd", 
    "style": "vivid"
}

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.

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

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

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

Menulis perintah gambar

Perintah gambar Anda harus menjelaskan konten yang ingin Anda lihat dalam gambar, dan gaya visual gambar.

Saat menulis perintah, pertimbangkan bahwa API pembuatan gambar dilengkapi dengan filter con mode tenda ration. Jika layanan mengenali permintaan Anda sebagai konten berbahaya, maka layanan tidak menghasilkan gambar. Untuk informasi selengkapnya, lihat Pemfilteran konten.

Tip

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 pembuatan gambar DALL-E.

Ukuran

Tentukan ukuran gambar yang dihasilkan. Harus salah satu dari 1024x1024, 1792x1024, atau 1024x1792 untuk model DALL-E 3. Gambar persegi lebih cepat untuk dihasilkan.

Gaya

DALL-E 3 memperkenalkan dua opsi gaya: natural dan vivid. Gaya alami lebih mirip dengan gaya default DALL-E 2, sementara gaya yang jelas menghasilkan gambar yang lebih nyata dan sinematik.

Gaya alami berguna dalam kasus di mana DALL-E 3 berlebihan atau membingungkan subjek yang dimaksudkan untuk menjadi lebih sederhana, subdus, atau realistis.

Nilai defaultnya adalah vivid.

Kualitas

Ada dua opsi untuk kualitas gambar: hd dan standard. Opsi hd membuat gambar dengan detail yang lebih halus dan konsistensi yang lebih besar di seluruh gambar. Gambar standar dapat dihasilkan lebih cepat.

Nilai defaultnya adalah standard.

Number

Dengan DALL-E 3, Anda tidak dapat menghasilkan lebih dari satu gambar dalam satu panggilan API: n parameter harus diatur ke 1. Jika Anda perlu membuat beberapa gambar sekaligus, buat permintaan paralel.

Format respons

Format di mana gambar yang dihasilkan dikembalikan. Harus salah satu dari url (URL yang menunjuk ke gambar) atau b64_json (kode dasar 64-byte dalam format JSON). Default adalah url.

Konten terkait