Aracılığıyla paylaş

DALL-E modelleriyle çalışmayı öğrenin

  • 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

  • Azure aboneliği. Ücretsiz bir tane oluşturun.
  • İstenen Azure aboneliğinde DALL-E'ye erişim izni verilir.
  • Bölgede oluşturulan SwedenCentral bir Azure OpenAI kaynağı.
  • Ardından Azure kaynağınızla bir dalle3 model dağıtmanız gerekir. Daha fazla bilgi için bkz . Azure OpenAI ile kaynak oluşturma ve model dağıtma.

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>

konumu:

  • <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 olarak Generated image was filtered as a result of our safety system.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 istemleri yazma

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

İpucu

Farklı türde görüntüler oluşturmak için metin istemlerinizi nasıl değiştirebileceğinizi ayrıntılı bir şekilde görmek için Dallery DALL-E 2 istem kitabına bakın.

İ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.

İstem dönüştürme

DALL-E 3, görüntüleri geliştirmek, yanlılıkları azaltmak ve görüntülerin doğal varyasyonunu artırmak için yerleşik istem yeniden yazmayı içerir.

Örnek metin istemi İstem dönüştürmesi olmadan oluşturulan örnek görüntü İstem dönüştürme ile oluşturulan örnek görüntü
"Seattle silüetinin suluboya resmi" Seattle silüetinin suluboya resmi (basit). Daha ayrıntılı ve yapılı Seattle silüetinin suluboya resmi.

Güncelleştirilmiş istem, veri yanıtı nesnesinin alanında görünür revised_prompt .

Şu anda bu özelliği devre dışı bırakmak mümkün olmasa da, aşağıdakini ekleyerek çıkışları özgün isteminize daha yakın hale getirmek için özel istem kullanabilirsiniz: I NEED to test how the tool works with extremely simple prompts. DO NOT add any detail, just use it AS-IS:.

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 sağlar: natural ve vivid. Stil natural , DALL-E 2 varsayılan stiline daha benzerken vivid , stil daha fazla hiper gerçek ve sinematik görüntü oluşturur.

BU natural stil, DALL-E 3'ün daha basit, altta tutulan 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 daha ayrıntılı görüntüler oluşturur ve görüntüde daha tutarlılık sağlar. standard 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 parametresi olarak 1ayarlanmalı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.

Sonraki adımlar