Aracılığıyla paylaş


Görüntü Analizi 3.2 API'sini çağırma

Bu makalede, görüntünün görsel özellikleri hakkında bilgi döndürmek için Görüntü Analizi 3.2 API'sinin nasıl çağrılacakları gösterilmektedir. Ayrıca istemci SDK'larını veya REST API'lerini kullanarak döndürülen bilgilerin nasıl ayrıştırıldığını da gösterir.

Bu kılavuzda zaten bir Görüntü İşleme kaynağı oluşturduğunuz ve bir anahtar ile uç nokta URL'si aldığınız varsayılır. İstemci SDK'sı kullanıyorsanız, bir istemci nesnesinin kimliğini de doğrulamanız gerekir. Bu adımları tamamlamadıysanız, başlamak için hızlı başlangıcı izleyin.

Hizmete veri gönderme

Bu kılavuzdaki kod, URL tarafından başvuruda bulunan uzak görüntüleri kullanır. Görüntü Analizi özelliklerinin tüm özelliklerini görmek için farklı görüntüleri kendiniz denemek isteyebilirsiniz.

Uzak görüntüyü analiz ederken, istek gövdesini şu şekilde biçimlendirerek görüntünün URL'sini belirtirsiniz: {"url":"http://example.com/images/test.jpg"}.

Yerel görüntüyü analiz etmek için ikili görüntü verilerini HTTP isteği gövdesine koyarsınız.

Verilerin nasıl işleneceğini belirleme

Görsel özellikleri seçme

Analiz API'si, hizmetin tüm görüntü çözümleme özelliklerine erişmenizi sağlar. Kendi kullanım örneğinize göre hangi işlemlerin gerçekleştirileceğini seçin. Her özelliğin açıklaması için genel bakışa bakın. Aşağıdaki bölümlerdeki örneklerde tüm kullanılabilir görsel özellikler eklenmiştir, ancak pratik kullanım için muhtemelen yalnızca bir veya iki görsele ihtiyacınız olacaktır.

Analiz API'sinin URL sorgu parametrelerini ayarlayarak hangi özellikleri kullanmak istediğinizi belirtebilirsiniz. Parametrenin virgülle ayrılmış birden çok değeri olabilir. Belirttiğiniz her özellik için daha fazla hesaplama süresi gerekir, bu nedenle yalnızca ihtiyacınız olanı belirtin.

URL parametresi Value Açıklama
features Read görüntüdeki görünür metni okur ve bunu yapılandırılmış JSON verileri olarak verir.
features Description desteklenen dillerde tam bir cümleyle görüntü içeriğini açıklar.
features SmartCrops , ilgi alanını korurken görüntüyü istenen en boy oranına kırpacak dikdörtgen koordinatlarını bulur.
features Objects , yaklaşık konum dahil olmak üzere bir görüntüdeki çeşitli nesneleri algılar. Nesneler bağımsız değişkeni yalnızca İngilizce kullanılabilir.
features Tags resmi, görüntü içeriğiyle ilgili sözcüklerin ayrıntılı bir listesiyle etiketler.

Doldurulmuş bir URL şöyle görünebilir:

<endpoint>/vision/v3.2/analyze?visualFeatures=Tags

Dilleri belirtme

Döndürülen verilerin dilini de belirtebilirsiniz.

Aşağıdaki URL sorgu parametresi dili belirtir. Varsayılan değer şudur: en.

URL parametresi Value Açıklama
language en İngilizce
language es İspanyolca
language ja Japonca
language pt Portekizce (Portekiz)
language zh Basitleştirilmiş Çince

Doldurulmuş bir URL şöyle görünebilir:

<endpoint>/vision/v3.2/analyze?visualFeatures=Tags&language=en

Hizmetten sonuç alma

Bu bölümde, API çağrısının sonuçlarını ayrıştırma gösterilmektedir. API çağrısının kendisini içerir.

Not

Kapsamlı API çağrıları

Görüntü Analizi'ndeki bazı özellikler doğrudan ve Analiz API'si çağrısı aracılığıyla çağrılabilir. Örneğin, bir istekte <endpoint>/vision/v3.2/tag bulunarak (veya SDK'daki ilgili yönteme) yalnızca görüntü etiketlerinin kapsamlı bir analizini yapabilirsiniz. Ayrı olarak çağrılabilecek diğer özellikler için başvuru belgelerine bakın.

Hizmet bir 200 HTTP yanıtı döndürür ve gövde döndürülen verileri JSON dizesi biçiminde içerir. Aşağıdaki metin bir JSON yanıtı örneğidir.

{
    "metadata":
    {
        "width": 300,
        "height": 200
    },
    "tagsResult":
    {
        "values":
        [
            {
                "name": "grass",
                "confidence": 0.9960499405860901
            },
            {
                "name": "outdoor",
                "confidence": 0.9956876635551453
            },
            {
                "name": "building",
                "confidence": 0.9893627166748047
            },
            {
                "name": "property",
                "confidence": 0.9853052496910095
            },
            {
                "name": "plant",
                "confidence": 0.9791355729103088
            }
        ]
    }
}

Hata kodları

Olası hataların ve bunların nedenlerinin aşağıdaki listesine bakın:

  • 400
    • InvalidImageUrl - Görüntü URL'si hatalı biçimlendirilmiş veya erişilebilir değil.
    • InvalidImageFormat - Giriş verileri geçerli bir görüntü değil.
    • InvalidImageSize - Giriş görüntüsü çok büyük.
    • NotSupportedVisualFeature - Belirtilen özellik türü geçerli değil.
    • NotSupportedImage - Desteklenmeyen görüntü, örneğin çocuk pornografisi.
    • InvalidDetails - Desteklenmeyen detail parametre değeri.
    • NotSupportedLanguage - İstenen işlem belirtilen dilde desteklenmiyor.
    • BadArgument - Hata iletisinde daha fazla ayrıntı sağlanır.
  • 415 - Desteklenmeyen medya türü hatası. İçerik Türü izin verilen türlerde değildir:
    • Resim URL'si için İçerik Türü application/json
    • İkili görüntü verileri için İçerik Türü veya olmalıdır application/octet-streammultipart/form-data
  • 500
    • FailedToProcess
    • Timeout - Görüntü işleme zaman aşımına uğradı.
    • InternalServerError

İpucu

Azure AI Vision ile çalışırken hizmet tarafından uygulanan hız sınırlarının neden olduğu geçici hatalarla veya ağ kesintileri gibi diğer geçici sorunlarla karşılaşabilirsiniz. Bu tür hataları işleme hakkında daha fazla bilgi için Bulut Tasarım Desenleri kılavuzundaki Yeniden deneme deseni kılavuzuna ve ilgili Devre Kesici düzenine bakın.

Sonraki adımlar