Analyze Image - Analyze Image

Başvuru

Hizmet:: Azure AI Services

API Sürümü:: 3.2

Bu işlem, görüntü içeriğine göre zengin bir görsel özellik kümesi ayıklar. İki giriş yöntemi desteklenir: (1) Görüntü karşıya yükleme veya (2) görüntü URL'si belirtme. İsteğinizin içinde, hangi özelliklerin döndürüleceğini seçmenize olanak tanıyan isteğe bağlı bir parametre vardır. Varsayılan olarak, yanıtta görüntü kategorileri döndürülür. JSON'da başarılı bir yanıt döndürülür. İstek başarısız olursa, yanıt bir hata kodu ve neyin yanlış gittiğini anlamanıza yardımcı olacak bir ileti içerir.

POST {Endpoint}/vision/v3.2/analyze

İsteğe bağlı parametrelerle:

POST {Endpoint}/vision/v3.2/analyze?visualFeatures={visualFeatures}&details={details}&language={language}&descriptionExclude={descriptionExclude}&model-version={model-version}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
Endpoint	path	True	string	Desteklenen Bilişsel Hizmetler uç noktaları.
descriptionExclude	query		DescriptionExclude[]	Açıklamayı oluştururken belirtilen etki alanı modellerini kapatın.
details	query		Details[]	Hangi etki alanına özgü ayrıntıların döndürüleceği belirten dize. Birden çok değer virgülle ayrılmalıdır. Geçerli görsel özellik türleri şunlardır: Ünlüler - görüntüde algılanırsa ünlüleri tanımlar, Yer İşaretleri - görüntüdeki önemli yer işaretlerini tanımlar.
language	query		string	Çıkış oluşturma için istenen dil. Bu parametre belirtilmezse, varsayılan değer "en" olur. Desteklenen dillerin listesi için bkz https://aka.ms/cv-languages .
model-version	query		string	Yapay zeka modelinin sürümünü belirtmek için isteğe bağlı parametre. Kabul edilen değerler şunlardır: "latest", "2021-04-01", "2021-05-01". Varsayılan olarak "en son" kullanılır. Normal ifade deseni: `^(latest\|\d{4}-\d{2}-\d{2})(-preview)?$`
visualFeatures	query		VisualFeatureTypes[]	Döndürülecek görsel özellik türlerini gösteren dize. Birden çok değer virgülle ayrılmalıdır. Geçerli görsel özellik türleri şunlardır: Kategoriler - belgelerde tanımlanan taksonomiye göre görüntü içeriğini kategorilere ayırır. Etiketler - Resmi, resim içeriğiyle ilgili ayrıntılı bir sözcük listesiyle etiketler. Açıklama - tam bir İngilizce cümle ile resim içeriğini açıklar. Yüzler - Yüzlerin mevcut olup olmadığını algılar. Varsa, koordinatlar, cinsiyet ve yaş oluşturun. ImageType - Görüntünün küçük resim mi yoksa çizgi çizim mi olduğunu algılar. Renk : Tema rengini, baskın rengi ve resmin siyah&beyaz olup olmadığını belirler. Yetişkin - görüntünün doğada pornografik olup olmadığını algılar (çıplaklığı veya seks eylemini gösterir) veya gory (aşırı şiddet veya kan gösterir). Cinsel içerik (diğer adıyla müstehcen içerik) de algılanır. Nesneler - yaklaşık konum dahil olmak üzere bir görüntü içindeki çeşitli nesneleri algılar. Nesneler bağımsız değişkeni yalnızca İngilizce kullanılabilir. Markalar - yaklaşık konum dahil olmak üzere bir görüntüdeki çeşitli markaları algılar. Brands bağımsız değişkeni yalnızca İngilizce kullanılabilir.

İstek Başlığı

Name	Gerekli	Tür	Description
Ocp-Apim-Subscription-Key	True	string

İstek Gövdesi

Name	Gerekli	Tür	Description
url	True	string	Görüntünün genel olarak erişilebilen URL'si.

Yanıtlar

Name	Tür	Description
200 OK	ImageAnalysis	Yanıt, JSON biçiminde ayıklanan özellikleri içerir. Numaralandırma türlerinin tanımları aşağıdadır: Küçük Resim Türü - küçük resim = 0, belirsiz = 1, normal - küçük resim = 2, iyi - küçük resim = 3. LineDrawingTypeNon - LineDrawing = 0, LineDrawing = 1.
Other Status Codes	ComputerVisionErrorResponse	Hata yanıtı.

Name

Tür

Description

200 OK

ImageAnalysis

Yanıt, JSON biçiminde ayıklanan özellikleri içerir. Numaralandırma türlerinin tanımları aşağıdadır:

Küçük Resim Türü

- küçük resim = 0, belirsiz = 1, normal - küçük resim = 2, iyi - küçük resim = 3. LineDrawingTypeNon - LineDrawing = 0, LineDrawing = 1.

Other Status Codes

ComputerVisionErrorResponse

Hata yanıtı.

Güvenlik

Ocp-Apim-Subscription-Key

Tür: apiKey
İçinde: header

Örnekler

Successful AnalyzeImage request

Örnek isteği

HTTP

POST https://westus.api.cognitive.microsoft.com/vision/v3.2/analyze?visualFeatures=Categories,Adult,Tags,Description,Faces,Color,ImageType,Objects,Brands&details=Celebrities,Landmarks&language=en


{
  "url": "{url}"
}

Örnek yanıt

Durum kodu:: 200

{
  "categories": [
    {
      "name": "abstract_",
      "score": 0.00390625
    },
    {
      "name": "people_",
      "score": 0.83984375,
      "detail": {
        "celebrities": [
          {
            "name": "Satya Nadella",
            "faceRectangle": {
              "left": 597,
              "top": 162,
              "width": 248,
              "height": 248
            },
            "confidence": 0.999028444
          }
        ]
      }
    },
    {
      "name": "building_",
      "score": 0.984375,
      "detail": {
        "landmarks": [
          {
            "name": "Forbidden City",
            "confidence": 0.9829016923904419
          }
        ]
      }
    }
  ],
  "adult": {
    "isAdultContent": false,
    "isRacyContent": false,
    "isGoryContent": false,
    "adultScore": 0.0934349000453949,
    "racyScore": 0.06861349195241928,
    "goreScore": 0.012872257380997575
  },
  "tags": [
    {
      "name": "person",
      "confidence": 0.9897908568382263
    },
    {
      "name": "man",
      "confidence": 0.9449388980865479
    },
    {
      "name": "outdoor",
      "confidence": 0.938492476940155
    },
    {
      "name": "window",
      "confidence": 0.8951393961906433
    },
    {
      "name": "pangolin",
      "confidence": 0.7250059783791661,
      "hint": "mammal"
    }
  ],
  "description": {
    "tags": [
      "person",
      "man",
      "outdoor",
      "window",
      "glasses"
    ],
    "captions": [
      {
        "text": "Satya Nadella sitting on a bench",
        "confidence": 0.48293603002174407
      }
    ]
  },
  "requestId": "0dbec5ad-a3d3-4f7e-96b4-dfd57efe967d",
  "metadata": {
    "width": 1500,
    "height": 1000,
    "format": "Jpeg"
  },
  "modelVersion": "2021-04-01",
  "faces": [
    {
      "age": 44,
      "gender": "Male",
      "faceRectangle": {
        "left": 593,
        "top": 160,
        "width": 250,
        "height": 250
      }
    }
  ],
  "color": {
    "dominantColorForeground": "Brown",
    "dominantColorBackground": "Brown",
    "dominantColors": [
      "Brown",
      "Black"
    ],
    "accentColor": "873B59",
    "isBWImg": false
  },
  "imageType": {
    "clipArtType": 0,
    "lineDrawingType": 0
  },
  "objects": [
    {
      "rectangle": {
        "x": 0,
        "y": 0,
        "w": 50,
        "h": 50
      },
      "object": "tree",
      "confidence": 0.9,
      "parent": {
        "object": "plant",
        "confidence": 0.95
      }
    }
  ],
  "brands": [
    {
      "name": "Pepsi",
      "confidence": 0.857,
      "rectangle": {
        "x": 489,
        "y": 79,
        "w": 161,
        "h": 177
      }
    },
    {
      "name": "Coca-Cola",
      "confidence": 0.893,
      "rectangle": {
        "x": 216,
        "y": 55,
        "w": 171,
        "h": 372
      }
    }
  ]
}

Tanımlar

Name	Description
AdultInfo	Görüntünün yetişkinlere yönelik içerik içerdiğini ve/veya müstehcen olup olmadığını açıklayan nesne.
BoundingRect	Görüntünün içindeki bir alan için sınırlayıcı kutu.
Category	Tanımlanan kategoriyi açıklayan bir nesne.
CategoryDetail	Ek kategori ayrıntılarını açıklayan bir nesne.
CelebritiesModel	Olası ünlü kimliğini açıklayan bir nesne.
ColorInfo	Renk özniteliklerini açıklayan ek meta veriler sağlayan bir nesne.
ComputerVisionError	API isteği hatası.
ComputerVisionErrorCodes	Hata kodu.
ComputerVisionErrorResponse	API hata yanıtı.
ComputerVisionInnerError	API isteği hatasıyla ilgili ayrıntılar.
ComputerVisionInnerErrorCodeValue	Hata kodu.
DescriptionExclude	Açıklamayı oluştururken belirtilen etki alanı modellerini kapatın.
Details	Hangi etki alanına özgü ayrıntıların döndürüleceği belirten bir dize. Birden çok değer virgülle ayrılmış olmalıdır. Geçerli görsel özellik türleri şunlardır: Ünlüler - görüntüde algılanırsa ünlüleri tanımlar, Yer İşaretleri - görüntüdeki önemli yer işaretlerini tanımlar.
DetectedBrand	Görüntüde algılanan bir marka.
DetectedObject	Görüntüde algılanan bir nesne.
FaceDescription	Görüntüde tanımlanan bir yüzü açıklayan nesne.
FaceRectangle	Yüz dikdörtgeni açıklayan bir nesne.
Gender	Yüzün olası cinsiyeti.
ImageAnalysis	AnalyzeImage işleminin sonucu.
ImageCaption	Resim başlık, yani resmin neleri resmettirildiğine ilişkin kısa bir açıklama.
ImageDescriptionDetails	Güvenilirlik düzeyine ve görüntü meta verilerine göre sıralanmış açıklamalı alt yazıların listesiyle birlikte içerik etiketleri koleksiyonu.
ImageMetadata	Görüntü meta verileri.
ImageTag	Görüntüde güvenilirlik puanıyla birlikte bir varlık gözlemi.
ImageType	Olası görüntü türlerini ve eşleşen güvenilirlik düzeylerini sağlayan bir nesne.
ImageUrl
LandmarksModel	Görüntüde tanınan bir yer işareti.
ObjectHierarchy	Görüntünün içinde algılanan bir nesne.
VisualFeatureTypes	Döndürülecek görsel özellik türlerini gösteren dize. Birden çok değer virgülle ayrılmış olmalıdır. Geçerli görsel özellik türleri şunlardır: Kategoriler - Belgelerde tanımlanan taksonomiye göre görüntü içeriğini kategorilere ayırır. Etiketler - resmi, resim içeriğiyle ilgili ayrıntılı bir sözcük listesiyle etiketler. Açıklama - resim içeriğini tam bir İngilizce cümleyle açıklar. Yüzler - yüzlerin mevcut olup olmadığını algılar. Varsa koordinatlar, cinsiyet ve yaş oluşturun. ImageType - Görüntünün küçük resim mi yoksa çizgi çizim mi olduğunu algılar. Renk : Tema rengini, baskın rengi ve görüntünün siyah&beyaz olup olmadığını belirler. Yetişkin - görüntünün doğada pornografik olup olmadığını algılar (çıplaklığı veya seks eylemini gösterir) veya gory (aşırı şiddet veya kan gösterir). Cinsel içerik (diğer adıyla müstehcen içerik) de algılanır. Nesneler - 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. Markalar - yaklaşık konum dahil olmak üzere bir görüntüdeki çeşitli markaları algılar. Markalar bağımsız değişkeni yalnızca İngilizce olarak kullanılabilir.

AdultInfo

Görüntünün yetişkinlere yönelik içerik içerdiğini ve/veya müstehcen olup olmadığını açıklayan nesne.

Name	Tür	Description
adultScore	number	İçeriğin görüntüde yetişkinlere yönelik olarak ne kadar olduğunu belirten 0 ile 1 arası puanlar.
goreScore	number	Gory'nin görüntünün nasıl olduğunu gösteren 0 ile 1 puanları.
isAdultContent	boolean	Görüntünün yetişkinlere yönelik içerik içerip içermediğini belirten bir değer.
isGoryContent	boolean	Görüntünün gory olup olmadığını belirten bir değer.
isRacyContent	boolean	Görüntünün müstehcen olup olmadığını gösteren bir değer.
racyScore	number	Görüntünün ne kadar önerili olduğunu gösteren 0 ile 1 puanları.

BoundingRect

Görüntünün içindeki bir alan için sınırlayıcı kutu.

Name	Tür	Description
h	integer	Alanın sol üst noktasından piksel cinsinden ölçülen yükseklik.
w	integer	Alanın sol üst noktasından piksel cinsinden ölçülen genişlik.
x	integer	Alanın sol üst noktasının piksel cinsinden X koordinatı.
y	integer	Alanın sol üst noktasının piksel cinsinden Y koordinatı.

Name	Tür	Description
detail	CategoryDetail	Tanımlanan kategorinin ayrıntıları.
name	string	Kategorinin adı.
score	number	Kategorinin puanlaması.

CategoryDetail

Ek kategori ayrıntılarını açıklayan bir nesne.

Name	Tür	Description
celebrities	CelebritiesModel[]	Tanımlandıysa ünlülerden oluşan bir dizi.
landmarks	LandmarksModel[]	Tanımlandıysa yer işaretleri dizisi.

CelebritiesModel

Olası ünlü kimliğini açıklayan bir nesne.

Name	Tür	Description
confidence	number	0 ile 1 arasında bir değer olarak ünlü tanıma için güvenilirlik düzeyi.
faceRectangle	FaceRectangle	Resimde tanımlanan yüzün konumu.
name	string	Ünlünün adı.

ColorInfo

Renk özniteliklerini açıklayan ek meta veriler sağlayan bir nesne.

Name	Tür	Description
accentColor	string	Olası vurgu rengi.
dominantColorBackground	string	Olası baskın arka plan rengi.
dominantColorForeground	string	Olası baskın ön plan rengi.
dominantColors	string[]	Olası baskın renkler dizisi.
isBWImg	boolean	Görüntünün siyah beyaz olup olmadığını gösteren bir değer.

ComputerVisionError

API isteği hatası.

Name	Tür	Description
code	ComputerVisionErrorCodes	Hata kodu.
innererror	ComputerVisionInnerError	İç hata daha ayrıntılı bilgiler içeriyor.
message	string	Hizmet tarafından bildirilen hatayı açıklayan bir ileti.

ComputerVisionErrorCodes

Hata kodu.

Name	Tür	Description
InternalServerError	string
InvalidArgument	string
InvalidRequest	string
ServiceUnavailable	string

ComputerVisionErrorResponse

API hata yanıtı.

Name	Tür	Description
error	ComputerVisionError	Hata içeriği.

ComputerVisionInnerError

API isteği hatasıyla ilgili ayrıntılar.

Name	Tür	Description
code	ComputerVisionInnerErrorCodeValue	Hata kodu.
message	string	Hata iletisi.

ComputerVisionInnerErrorCodeValue

Hata kodu.

Name	Tür	Description
BadArgument	string
CancelledRequest	string
DetectFaceError	string
FailedToProcess	string
InternalServerError	string
InvalidDetails	string
InvalidImageFormat	string
InvalidImageSize	string
InvalidImageUrl	string
InvalidModel	string
InvalidThumbnailSize	string
NotSupportedFeature	string
NotSupportedImage	string
NotSupportedLanguage	string
NotSupportedVisualFeature	string
StorageException	string
Timeout	string
Unspecified	string
UnsupportedMediaType	string

DescriptionExclude

Açıklamayı oluştururken belirtilen etki alanı modellerini kapatın.

Name	Tür	Description
Celebrities	string
Landmarks	string

Details

Hangi etki alanına özgü ayrıntıların döndürüleceği belirten bir dize. Birden çok değer virgülle ayrılmış olmalıdır. Geçerli görsel özellik türleri şunlardır: Ünlüler - görüntüde algılanırsa ünlüleri tanımlar, Yer İşaretleri - görüntüdeki önemli yer işaretlerini tanımlar.

Name	Tür	Description
Celebrities	string
Landmarks	string

DetectedBrand

Görüntüde algılanan bir marka.

Name	Tür	Description
confidence	number	Görüntüdeki markayı 0 ile 1 arasında bir değer olarak gözlemlediklerinin güvenilirlik puanı.
name	string	Marka etiketi.
rectangle	BoundingRect	Algılanan markanın yaklaşık konumu.

DetectedObject

Görüntüde algılanan bir nesne.

Name	Tür	Description
confidence	number	Görüntüdeki nesneyi 0 ile 1 arasında bir değer olarak gözlemledikten sonra elde edilen güvenilirlik puanı.
object	string	Nesne etiketi.
parent	ObjectHierarchy	Taksonomi açısından üst nesne. Üst nesne, bu nesnenin daha genel bir biçimidir. Örneğin, bir 'bulldog' 'köpek' ebeveyni olabilir.
rectangle	BoundingRect	Algılanan nesnenin yaklaşık konumu.

FaceDescription

Görüntüde tanımlanan bir yüzü açıklayan nesne.

Name	Tür	Description
age	integer	Yüzün olası yaşı.
faceRectangle	FaceRectangle	Resimde, tanımlanan yüzü içeren dikdörtgen.
gender	Gender	Yüzün olası cinsiyeti.

FaceRectangle

Yüz dikdörtgeni açıklayan bir nesne.

Name	Tür	Description
height	integer	Yüzün sol üst noktasından piksel cinsinden ölçülen yükseklik.
left	integer	Yüzün sol üst noktasının piksel cinsinden X koordinatı.
top	integer	Yüzün sol üst noktasının piksel cinsinden Y koordinatı.
width	integer	Yüzün sol üst noktasından piksel cinsinden ölçülen genişlik.

Gender

Yüzün olası cinsiyeti.

Name	Tür	Description
Female	string
Male	string

ImageAnalysis

AnalyzeImage işleminin sonucu.

Name	Tür	Description
adult	AdultInfo	Görüntünün yetişkinlere yönelik içerik içerdiğini ve/veya müstehcen olup olmadığını açıklayan nesne.
brands	DetectedBrand[]	Görüntüde algılanan marka dizisi.
categories	Category[]	Tanımlanan kategorileri gösteren bir dizi.
color	ColorInfo	Renk özniteliklerini açıklayan ek meta veriler sağlayan bir nesne.
description	ImageDescriptionDetails	Güvenilirlik düzeyine ve görüntü meta verilerine göre sıralanmış açıklamalı alt yazıların listesiyle birlikte içerik etiketleri koleksiyonu.
faces	FaceDescription[]	Görüntüdeki olası yüzler dizisi.
imageType	ImageType	Olası görüntü türlerini ve eşleşen güvenilirlik düzeylerini sağlayan bir nesne.
metadata	ImageMetadata	Görüntü meta verileri.
modelVersion	string	Yapay zeka modelinin sürümü.
objects	DetectedObject[]	Görüntüde algılananları açıklayan nesne dizisi.
requestId	string	REST API isteğinin kimliği.
tags	ImageTag[]	Güvenilirlik düzeyine sahip etiketlerin listesi.

ImageCaption

Resim başlık, yani resmin neleri resmettirildiğine ilişkin kısa bir açıklama.

Name	Tür	Description
confidence	number	Hizmetin başlık sahip olduğu güvenilirlik düzeyi.
text	string	başlık metni.

ImageDescriptionDetails

Güvenilirlik düzeyine ve görüntü meta verilerine göre sıralanmış açıklamalı alt yazıların listesiyle birlikte içerik etiketleri koleksiyonu.

Name	Tür	Description
captions	ImageCaption[]	Güvenilirlik düzeyine göre sıralanmış resim yazıları listesi.
tags	string[]	Görüntü etiketleri koleksiyonu.

ImageMetadata

Görüntü meta verileri.

Name	Tür	Description
format	string	Görüntü biçimi.
height	integer	Piksel cinsinden resim yüksekliği.
width	integer	Piksel cinsinden görüntü genişliği.

ImageTag

Görüntüde güvenilirlik puanıyla birlikte bir varlık gözlemi.

Name	Tür	Description
confidence	number	Varlığın gözlemlendiği güvenilirlik düzeyi.
hint	string	Bu etiket için isteğe bağlı ipucu/ayrıntılar.
name	string	Varlığın adı.

ImageType

Olası görüntü türlerini ve eşleşen güvenilirlik düzeylerini sağlayan bir nesne.

Name	Tür	Description
clipArtType	integer	Görüntünün küçük resim olduğuna ilişkin güvenilirlik düzeyi.
lineDrawingType	integer	Görüntünün bir çizgi çizimi olduğuna dair güvenilirlik düzeyi.

ImageUrl

Name	Tür	Description
url	string	Görüntünün genel olarak erişilebilen URL'si.

LandmarksModel

Görüntüde tanınan bir yer işareti.

Name	Tür	Description
confidence	number	Yer işareti tanıma için 0 ile 1 arasında bir değer olarak güvenilirlik düzeyi.
name	string	Yer işareti adı.

ObjectHierarchy

Görüntünün içinde algılanan bir nesne.

Name	Tür	Description
confidence	number	Görüntüdeki nesneyi 0 ile 1 arasında bir değer olarak gözlemledikten sonra elde edilen güvenilirlik puanı.
object	string	Nesnenin etiketi.
parent	ObjectHierarchy	Taksonomi açısından üst nesne. Üst nesne, bu nesnenin daha genel bir biçimidir. Örneğin, bir 'bulldog' 'köpek' ebeveyni olabilir.

VisualFeatureTypes

Döndürülecek görsel özellik türlerini gösteren dize. Birden çok değer virgülle ayrılmış olmalıdır. Geçerli görsel özellik türleri şunlardır: Kategoriler - Belgelerde tanımlanan taksonomiye göre görüntü içeriğini kategorilere ayırır. Etiketler - resmi, resim içeriğiyle ilgili ayrıntılı bir sözcük listesiyle etiketler. Açıklama - resim içeriğini tam bir İngilizce cümleyle açıklar. Yüzler - yüzlerin mevcut olup olmadığını algılar. Varsa koordinatlar, cinsiyet ve yaş oluşturun. ImageType - Görüntünün küçük resim mi yoksa çizgi çizim mi olduğunu algılar. Renk : Tema rengini, baskın rengi ve görüntünün siyah&beyaz olup olmadığını belirler. Yetişkin - görüntünün doğada pornografik olup olmadığını algılar (çıplaklığı veya seks eylemini gösterir) veya gory (aşırı şiddet veya kan gösterir). Cinsel içerik (diğer adıyla müstehcen içerik) de algılanır. Nesneler - 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. Markalar - yaklaşık konum dahil olmak üzere bir görüntüdeki çeşitli markaları algılar. Markalar bağımsız değişkeni yalnızca İngilizce olarak kullanılabilir.

Name	Tür	Description
Adult	string
Brands	string
Categories	string
Color	string
Description	string
Faces	string
ImageType	string
Objects	string
Tags	string

Aracılığıyla paylaş

Analyze Image - Analyze Image

URI Parametreleri

İstek Başlığı

İstek Gövdesi

Yanıtlar

Güvenlik

Ocp-Apim-Subscription-Key

Örnekler

Successful AnalyzeImage request

Örnek isteği

Örnek yanıt

Tanımlar

AdultInfo

BoundingRect

Category

CategoryDetail

CelebritiesModel

ColorInfo

ComputerVisionError

ComputerVisionErrorCodes

ComputerVisionErrorResponse

ComputerVisionInnerError

ComputerVisionInnerErrorCodeValue

DescriptionExclude

Details

DetectedBrand

DetectedObject

FaceDescription

FaceRectangle

Gender

ImageAnalysis

ImageCaption

ImageDescriptionDetails

ImageMetadata

ImageTag

ImageType

ImageUrl

LandmarksModel

ObjectHierarchy

VisualFeatureTypes

Ek kaynaklar