DALL-E modellerini kullanma
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şturabilirsiniz.
- Desteklenen bir bölgede oluşturulan bir Azure OpenAI kaynağı. Bkz. Bölge kullanılabilirliği.
-
- Azure OpenAI kaynağınızla bir dall-e-3 modeli dağıtın.
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 contentFilter
ayarlanı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 1024x1024
1792x1024
biri , 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
.