Aracılığıyla paylaş

DALL-E modellerini kullanma

  • Makale

OpenAI'nin DALL-E modelleri, kullanıcı tarafından sağlanan metin istemlerini temel alan görüntüler oluşturur. Bu kılavuzda, REST API çağrıları aracılığıyla DALL-E modellerini kullanma ve seçeneklerini yapılandırma adımları gösterilmektedir.

Önkoşullar

Görüntü Oluşturma API'lerini çağırma

Aşağıdaki komut, DALL-E'yi kodla kullanmanın en temel yolunu gösterir. Bu modelleri program aracılığıyla ilk kez kullanıyorsanız, DALL-E hızlı başlangıcıyla başlamanızı öneririz.

Şu adresine post isteği gönderin:

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

Aşağıdaki yer tutucuları değiştirin:

  • <your_resource_name> , Azure OpenAI kaynağınızın adıdır.
  • <your_deployment_name> , DALL-E 3 model dağıtımınızın adıdır.
  • <api_version> kullanmak istediğiniz API sürümüdür. Örneğin, 2024-02-01.

Gerekli üst bilgiler:

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

Gövde:

Aşağıda örnek bir istek gövdesi verilmiştir. Sonraki bölümlerde tanımlanan bir dizi seçenek belirtirsiniz.

{
    "prompt": "A multi-colored umbrella on the beach, disposable camera",
    "size": "1024x1024", 
    "n": 1,
    "quality": "hd", 
    "style": "vivid"
}

Çıktı

Başarılı bir görüntü oluşturma API çağrısının çıktısı aşağıdaki örneğe benzer. alanı, url oluşturulan görüntüyü indirebileceğiniz bir URL içerir. URL 24 saat boyunca etkin kalır.

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

API çağrısı reddetme

İstemler ve görüntüler, içerik ilkemize göre filtrelenir ve bir istem veya görüntü işaretlendiğinde hata döndürür.

İsteminiz bayrakla işaretlenmişse, error.code iletideki değer olarak contentFilterayarlanır. Bir örnek aşağıda verilmiştir:

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

Oluşturulan görüntünün kendisi de filtrelenmiş olabilir. Bu durumda hata iletisi, Güvenlik sistemimizin bir sonucu olarak Oluşturulan görüntü filtrelendi olarak ayarlanır. Bir örnek aşağıda verilmiştir:

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

Resim yazma istemleri

Görüntü istemleriniz, görüntüde görmek istediğiniz içeriği ve resmin görsel stilini açıklamalıdır.

İstemler yazarken, görüntü oluşturma API'lerinin con çadır modu ration filtresiyle birlikte geldiğini göz önünde bulundurun. Hizmet isteminizi zararlı içerik olarak algılarsa bir görüntü oluşturmaz. Daha fazla bilgi için bkz . İçerik filtreleme.

İpucu

Farklı türde görüntüler oluşturmak için metin istemlerinizi nasıl değiştirebileceğinize ilişkin ayrıntılı bir bakış için Görüntü istemi mühendislik kılavuzuna bakın.

API seçeneklerini belirtme

DALL-E görüntü oluşturma için aşağıdaki API gövde parametreleri kullanılabilir.

Size

Oluşturulan görüntülerin boyutunu belirtin. DALL-E 3 modellerinden 1024x10241792x1024biri , veya 1024x1792 olmalıdır. Kare görüntülerin oluşturulması daha hızlıdır.

Stil

DALL-E 3 iki stil seçeneği sunar: natural ve vivid. Doğal stil, eski modellerin varsayılan stiline daha benzerken canlı stil daha fazla hiper gerçek ve sinematik görüntü oluşturur.

Doğal stil, DALL-E 3'ün daha basit, altta veya gerçekçi olması amaçlanan bir konuyu aşırı abarttığı veya karıştırdığı durumlarda kullanışlıdır.

Varsayılan değer şudur: vivid.

Kalite

Görüntü kalitesi için iki seçenek vardır: hd ve standard. Hd seçeneği, görüntü genelinde daha ayrıntılı ve daha tutarlı görüntüler oluşturur. Standart görüntüler daha hızlı oluşturulabilir.

Varsayılan değer şudur: standard.

Sayı

DALL-E 3 ile tek bir API çağrısında birden fazla görüntü oluşturamazsınız: n parametre 1 olarak ayarlanmalıdır. Aynı anda birden çok görüntü oluşturmanız gerekiyorsa paralel isteklerde bulunabilirsiniz.

Yanıt biçimi

Oluşturulan görüntülerin döndürüldiği biçim. Bunlardan biri url (görüntüye işaret eden bir URL) veya b64_json (JSON biçiminde temel 64 baytlık kod) olmalıdır. Varsayılan değer: url.

İlgili içerik