Aracılığıyla paylaş

Azure OpenAI görüntü oluşturma modellerini kullanma

OpenAI'nin görüntü oluşturma modelleri, kullanıcı tarafından sağlanan metin istemlerini ve isteğe bağlı olarak sağlanan görüntüleri temel alarak görüntüleri işler. Bu kılavuzda, REST API çağrıları aracılığıyla görüntü oluşturma modellerinin nasıl kullanılacağı ve seçeneklerinin nasıl yapılandırılır gösterilmektedir.

Önkoşullar

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

Aşağıdaki komut, kodla görüntü modelini kullanmanın en temel yolunu gösterir. Bu modelleri program aracılığıyla ilk kez kullanıyorsanız , hızlı başlangıç ile 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>

URL:

Aşağıdaki değerleri değiştirin:

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

Gerekli başlıklar:

  • 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",
    "model": "gpt-image-1",
    "size": "1024x1024", 
    "n": 1,
    "quality": "high"
}

Tavsiye

Görüntü oluşturma belirteci maliyetleri için bkz. Görüntü belirteçleri.

Çıktı

Başarılı bir görüntü oluşturma API çağrısının yanıtı 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. İşte bir örnek:

{
    "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. İşte bir örnek:

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

Metinden görüntüye istemler yazma

İstemleriniz, 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ü API'lerinin içerik denetleme 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.

Tavsiye

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

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

Boyut

Oluşturulan görüntülerin boyutunu belirtin. GPT-image-1 modellerinden 1024x10241024x15361536x1024 biri olmalıdır. Kare görüntülerin oluşturulması daha hızlıdır.

Nitelik

Görüntü kalitesi için üç seçenek vardır: low, mediumve high. Daha düşük kaliteli görüntüler daha hızlı oluşturulabilir.

Varsayılan değer şudur: high.

Sayı

Tek bir API çağrısında bir ile 10 arasında görüntü oluşturabilirsiniz. Varsayılan değer şudur: 1.

Kullanıcı Kimliği

İstekte bulunan kullanıcı için benzersiz bir tanımlayıcı belirtmek üzere kullanıcı parametresini kullanın. Bu, kullanım kalıplarını takip etmek ve gözlemlemek için kullanışlıdır. Değer, kullanıcı kimliği veya e-posta adresi gibi herhangi bir dize olabilir.

Çıkış biçimi

Oluşturulan görüntünün biçimini belirtmek için output_format parametresini kullanın. Desteklenen biçimler PNG ve JPEG'dir. Varsayılan değer: PNG.

Uyarı

Azure AI Foundry Modellerinde, Azure OpenAI'de WEBP görüntüleri desteklenmez.

Sıkıştırma

Oluşturulan görüntünün sıkıştırma düzeyini belirtmek için output_compression parametresini kullanın. ile 0arasında 100 bir tamsayı girdiniz; burada 0 sıkıştırma yoktur ve 100 sıkıştırma üst sınırıdır. Varsayılan değer: 100.

Görüntü Düzenleme API'sini çağırma

Görüntü Düzenleme API'si, sağladığınız metin istemlerine göre mevcut görüntüleri değiştirmenize olanak tanır. API çağrısı, görüntü oluşturma API çağrısına benzer, ancak bir giriş görüntüsü de sağlamanız gerekir.

Önemli

Giriş görüntüsünün boyutu 20 MB'tan küçük olmalı ve PNG veya JPG dosyası olmalıdır.

Şu adresine post isteği gönderin:

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

URL:

Aşağıdaki değerleri değiştirin:

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

Gerekli başlıklar:

  • Content-Type: multipart/form-data
  • 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.

Önemli

Görüntü Düzenleme API'si JSON verilerini değil çok parçalı/form verilerini alır. Aşağıdaki örnekte bir cURL isteğine eklenecek örnek form verileri gösterilmektedir.

-F "image[]=@beach.png" \
-F 'prompt=Add a beach ball in the center' \
-F "model=gpt-image-1" \
-F "size=1024x1024" \
-F "n=1" \
-F "quality=high"

Çıktı

Başarılı bir görüntü düzenleme API çağrısının yanıtı aşağıdaki örneğe benzer. alanı b64_json çıktı görüntüsü verilerini içerir.

{ 
    "created": 1698116662, 
    "data": [ 
        { 
            "b64_json": "<base64 image data>",
            "revised_prompt": "<prompt_that_was_used>" 
        }
    ]
}

API seçeneklerini belirtme

Görüntü oluşturma modellerinde kullanılabilenlere ek olarak görüntü düzenleme modelleri için aşağıdaki API gövde parametreleri kullanılabilir.

Resim

Görüntü değeri, düzenlemek istediğiniz görüntü dosyasını gösterir.

Maske

Mask parametresi, ana görüntü giriş parametresiyle aynı türdedir. Bu alanlarda tamamen saydam pikselleri (sıfırın alfası) kullanarak modelin düzenlemesini istediğiniz görüntü alanını tanımlar. Maske bir PNG dosyası olmalı ve giriş görüntüsüyle aynı boyutlara sahip olmalıdır.

İlgili içerik