DALL-E modelleriyle çalışmayı öğrenin
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 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 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" |
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 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 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 1
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
.
Sonraki adımlar
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin