Image Analysis - Analyze Stream

Başvuru

Hizmet:: Azure AI Services

API Sürümü:: 2023-04-01-preview

Giriş görüntüsünü analiz edin. İstek herhangi bir içerik türüne sahip ['image/*', 'application/octet-stream'] görüntü akışı veya görüntü akışını almak için kullanılacak url özelliğini içeren bir JSON yükü içerir.

POST /imageanalysis:analyze?overload=stream&api-version=2023-04-01-preview

İsteğe bağlı parametrelerle:

POST /imageanalysis:analyze?overload=stream&features={features}&model-name={model-name}&language={language}&smartcrops-aspect-ratios={smartcrops-aspect-ratios}&gender-neutral-caption={gender-neutral-caption}&api-version=2023-04-01-preview

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
api-version	query	True	string	İstenen API sürümü.
features	query		VisualFeature[]	İstenen görsel özellikleri: etiketler, nesneler, resim yazısı, denseCaptions, read, smartCrops, people. "model-name" parametresi belirtilmezse bu parametrenin belirtilmesi gerekir.
gender-neutral-caption	query		boolean	Açıklamalı alt yazılar ve denseCaptions özellikleri için cinsiyet açısından bağımsız açıklamalı alt yazıyı etkinleştirmeye yönelik Boole bayrağı. Bu parametre belirtilmezse, varsayılan değer "false" olur.
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-name	query		string	Özel eğitilen modelin adı. "özellikler" parametresi belirtilmezse bu parametrenin belirtilmesi gerekir.
smartcrops-aspect-ratios	query		string	smartCrops özelliği için kullanılacak en boy oranlarının listesi. En boy oranları, hedef kırpma genişliği yüksekliğe bölünerek hesaplanır. Desteklenen değerler 0,75 ile 1,8 (dahil) arasındadır. Birden çok değer virgülle ayrılmış olmalıdır. Bu parametre belirtilmezse, hizmet 0,5 ile 2,0 (dahil) arasında uygun gördüğü en boy oranına sahip bir kırpma önerisi döndürür.

İstek Gövdesi

Media Types: "application/octet-stream", "image/jpeg", "image/gif", "image/tiff", "image/bmp", "image/png"

Name	Tür	Description
body	string	Görüntü akışı.

Yanıtlar

Name	Tür	Description
200 OK	ImageAnalysisResult	Başarılı
Other Status Codes	ErrorResponse	Hata Üst Bilgiler x-ms-error-code: string

Name

Tür

Description

200 OK

ImageAnalysisResult

Başarılı

Other Status Codes

ErrorResponse

Hata

Üst Bilgiler

x-ms-error-code: string

Örnekler

AnalyzeImageFromImageStream_CustomModel

Örnek isteği

HTTP

POST /imageanalysis:analyze?overload=stream&model-name=my_model_name&api-version=2023-04-01-preview

"Ynl0ZXM="

Örnek yanıt

Durum kodu:: 200

{
  "modelVersion": "2023-04-01-preview",
  "customModelResult": {
    "objectsResult": {
      "values": [
        {
          "id": "1",
          "boundingBox": {
            "x": 197,
            "y": 68,
            "w": 356,
            "h": 394
          },
          "tags": [
            {
              "name": "class1",
              "confidence": 0.92431640625
            }
          ]
        },
        {
          "id": "2",
          "boundingBox": {
            "x": 0,
            "y": 77,
            "w": 241,
            "h": 359
          },
          "tags": [
            {
              "name": "class1",
              "confidence": 0.87890625
            }
          ]
        }
      ]
    }
  },
  "metadata": {
    "width": 660,
    "height": 495
  }
}

Tanımlar

Name	Description
AdultMatch	Yetişkinlere yönelik içerik eşleşmesi açıklayan bir nesne.
AdultResult	Görüntünün yetişkinlere yönelik içerik içerdiğini ve/veya müstehcen olup olmadığını açıklayan nesne.
BoundingBox	Görüntünün içindeki bir alan için sınırlayıcı kutu.
CaptionResult	Resmin neleri resmettirildiğine ilişkin kısa bir açıklama.
CropRegion	Akıllı kırpma için tanımlanan bölge. İstenen her en boy oranı için bir bölge döndürülür.
DenseCaption	Resmin neleri resmettirildiğine ilişkin kısa bir açıklama.
DenseCaptionsResult	Resim yazısı listesi.
DetectedObject	Bir görüntüde algılanan nesneyi açıklar.
DetectedPerson	Görüntüde algılanan bir kişi.
DocumentLine	Sözcükler ve seçim işaretleri gibi bitişik bir içerik öğesi dizisini içeren bir içerik satırı nesnesi.
DocumentPage	Girişten bir sayfadan ayıklanan içerik ve düzen öğeleri.
DocumentSpan	Uzaklık ve uzunluk olarak belirtilen, birleştirilmiş içerik özelliğinin bitişik bölgesi.
DocumentStyle	Gözlemlenen metin stillerini temsil eden bir nesne.
DocumentWord	Bitişik karakter dizisinden oluşan bir sözcük nesnesi. Çince, Japonca ve Korece gibi boşlukla sınırlandırılmamış diller için her karakter kendi sözcüğü olarak temsil edilir.
ErrorResponse	Bir hata oluştuğunda yanıt döndürülür.
ErrorResponseDetails	Hata bilgileri.
ErrorResponseInnerError	Ayrıntılı hata.
ImageAnalysisResult	Farklı görüntü analizi türlerinin birleşik sonuçlarını açıklama.
ImageMetadataApiModel	Yükseklik ve genişlik gibi görüntü meta veri bilgileri.
ImagePredictionResult	Bir görüntünün tahmin sonucunu açıklar.
ObjectsResult	Bir görüntüde algılanan nesneleri açıklar.
PeopleResult	Görüntünün kişi içerip içermediğini açıklayan bir nesne.
ReadResult	Okuma işleminin sonuçları.
SmartCropsResult	Akıllı kırpma sonucu.
Tag	Görüntüde güvenilirlik puanıyla birlikte bir varlık gözlemi.
TagsResult	Güvenilirlik düzeyine sahip etiketlerin listesi.
VisualFeature	İstenen görsel özellikleri: etiketler, nesneler, resim yazısı, denseCaptions, read, smartCrops, people. "model-name" parametresi belirtilmezse bu parametrenin belirtilmesi gerekir.

AdultMatch

Yetişkinlere yönelik içerik eşleşmesi açıklayan bir nesne.

Name	Tür	Description
confidence	number	Eşleşen yetişkinlere yönelik içeriğin güvenilirlik düzeyini gösteren değer.
isMatch	boolean	Görüntünün yetişkinlere yönelik içerikle eşleşip eşleşmediğini belirten bir değer.

AdultResult

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
adult	AdultMatch	Yetişkinlere yönelik içerik eşleşmesi açıklayan bir nesne.
gore	AdultMatch	Yetişkinlere yönelik içerik eşleşmesi açıklayan bir nesne.
racy	AdultMatch	Yetişkinlere yönelik içerik eşleşmesi açıklayan bir nesne.

BoundingBox

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 sol koordinatı.
y	integer	Alanın sol üst noktasının piksel cinsinden üst koordinatı.

CaptionResult

Resmin neleri resmettirildiğine ilişkin kısa bir açıklama.

Name	Tür	Description
confidence	number	Hizmetin resim yazısında sahip olduğu güvenilirlik düzeyi.
text	string	Resim yazısının metni.

CropRegion

Akıllı kırpma için tanımlanan bölge. İstenen her en boy oranı için bir bölge döndürülür.

Name	Tür	Description
aspectRatio	number	Kırpma bölgesinin en boy oranı.
boundingBox	BoundingBox	Görüntünün içindeki bir alan için sınırlayıcı kutu.

DenseCaption

Resmin neleri resmettirildiğine ilişkin kısa bir açıklama.

Name	Tür	Description
boundingBox	BoundingBox	Görüntünün içindeki bir alan için sınırlayıcı kutu.
confidence	number	Hizmetin resim yazısında sahip olduğu güvenilirlik düzeyi.
text	string	Resim yazısının metni.

DenseCaptionsResult

Resim yazısı listesi.

Name	Tür	Description
values	DenseCaption[]	Resim yazısı listesi.

DetectedObject

Bir görüntüde algılanan nesneyi açıklar.

Name	Tür	Description
boundingBox	BoundingBox	Görüntünün içindeki bir alan için sınırlayıcı kutu.
id	string	Algılanan nesnenin kimliği.
tags	Tag[]	Algılanan nesnenin sınıflandırma güvenleri.

DetectedPerson

Görüntüde algılanan bir kişi.

Name	Tür	Description
boundingBox	BoundingBox	Görüntünün içindeki bir alan için sınırlayıcı kutu.
confidence	number	Görüntüdeki kişiyi 0 ile 1 arasında bir değer olarak gözlemledikten sonra elde edilen güvenilirlik puanı.

DocumentLine

Sözcükler ve seçim işaretleri gibi bitişik bir içerik öğesi dizisini içeren bir içerik satırı nesnesi.

Name	Tür	Description
boundingBox	number[]	Satırın sınırlayıcı kutusu.
content	string	İçeren öğelerin içeriği okuma sırasına göre birleştirilir.
spans	DocumentSpan[]	Satırın okuma sırası birleştirilmiş içerikteki konumu.

DocumentPage

Girişten bir sayfadan ayıklanan içerik ve düzen öğeleri.

Name	Tür	Description
angle	number	İçeriğin saat yönündeki genel yönü, (-180, 180] arasında derece cinsinden ölçülür.
height	number	Resmin/PDF'nin yüksekliği sırasıyla piksel/inç cinsindendir.
lines	DocumentLine[]	Hem metin hem de görsel öğeler içeren sayfadan ayıklanan satırlar.
pageNumber	integer	Giriş belgesinde 1 tabanlı sayfa numarası.
spans	DocumentSpan[]	Sayfanın okuma sırası birleştirilmiş içerikteki konumu.
width	number	Resmin/PDF'nin piksel/inç cinsinden genişliği sırasıyla.
words	DocumentWord[]	Sayfadan ayıklanan sözcükler.

DocumentSpan

Uzaklık ve uzunluk olarak belirtilen, birleştirilmiş içerik özelliğinin bitişik bölgesi.

Name	Tür	Description
length	integer	yayılma alanı tarafından temsil edilen içerikteki karakter sayısı.
offset	integer	Yayılma alanı tarafından temsil edilen içeriğin sıfır tabanlı dizini.

DocumentStyle

Gözlemlenen metin stillerini temsil eden bir nesne.

Name	Tür	Description
confidence	number	Stili doğru şekilde tanımlamanın güvenilirliği.
isHandwritten	boolean	İçerik el yazısıyla yazılmış mı değil mi?
spans	DocumentSpan[]	Stilin uygulandığı birleştirilmiş içerikteki metin öğelerinin konumu.

DocumentWord

Bitişik karakter dizisinden oluşan bir sözcük nesnesi. Çince, Japonca ve Korece gibi boşlukla sınırlandırılmamış diller için her karakter kendi sözcüğü olarak temsil edilir.

Name	Tür	Description
boundingBox	number[]	Sözcüğün sınırlayıcı kutusu.
confidence	number	Sözcüğü doğru ayıklama güveni.
content	string	Sözcüğün metin içeriği.
span	DocumentSpan	Uzaklık ve uzunluk olarak belirtilen, birleştirilmiş içerik özelliğinin bitişik bölgesi.

ErrorResponse

Bir hata oluştuğunda yanıt döndürülür.

Name	Tür	Description
error	ErrorResponseDetails	Hata bilgileri.

ErrorResponseDetails

Hata bilgileri.

Name	Tür	Description
code	string	Hata kodu.
details	ErrorResponseDetails[]	Ayrıntılı hataların listesi.
innererror	ErrorResponseInnerError	Ayrıntılı hata.
message	string	Hata iletisi.
target	string	Hatanın hedefi.

ErrorResponseInnerError

Ayrıntılı hata.

Name	Tür	Description
code	string	Hata kodu.
innererror	ErrorResponseInnerError	Ayrıntılı hata.
message	string	Hata iletisi.

ImageAnalysisResult

Farklı görüntü analizi türlerinin birleşik sonuçlarını açıklama.

Name	Tür	Description
adultResult	AdultResult	Görüntünün yetişkinlere yönelik içerik içerdiğini ve/veya müstehcen olup olmadığını açıklayan nesne.
captionResult	CaptionResult	Resmin neleri resmettirildiğine ilişkin kısa bir açıklama.
customModelResult	ImagePredictionResult	Bir görüntünün tahmin sonucunu açıklar.
denseCaptionsResult	DenseCaptionsResult	Resim yazısı listesi.
metadata	ImageMetadataApiModel	Yükseklik ve genişlik gibi görüntü meta veri bilgileri.
modelVersion	string	Model Sürümü.
objectsResult	ObjectsResult	Bir görüntüde algılanan nesneleri açıklar.
peopleResult	PeopleResult	Görüntünün kişi içerip içermediğini açıklayan bir nesne.
readResult	ReadResult	Okuma işleminin sonuçları.
smartCropsResult	SmartCropsResult	Akıllı kırpma sonucu.
tagsResult	TagsResult	Güvenilirlik düzeyine sahip etiketlerin listesi.

ImageMetadataApiModel

Yükseklik ve genişlik gibi görüntü meta veri bilgileri.

Name	Tür	Description
height	integer	Görüntünün piksel cinsinden yüksekliği.
width	integer	Resmin piksel cinsinden genişliği.

ImagePredictionResult

Bir görüntünün tahmin sonucunu açıklar.

Name	Tür	Description
objectsResult	ObjectsResult	Bir görüntüde algılanan nesneleri açıklar.
tagsResult	TagsResult	Güvenilirlik düzeyine sahip etiketlerin listesi.

ObjectsResult

Bir görüntüde algılanan nesneleri açıklar.

Name	Tür	Description
values	DetectedObject[]	Algılanan nesne dizisi.

PeopleResult

Görüntünün kişi içerip içermediğini açıklayan bir nesne.

Name	Tür	Description
values	DetectedPerson[]	Algılanan kişilerden oluşan bir dizi.

ReadResult

Okuma işleminin sonuçları.

Name	Tür	Description
content	string	Tüm metinsel ve görsel öğelerin dize gösterimini okuma sırasına göre birleştirin.
pages	DocumentPage[]	Analiz edilen sayfaların listesi.
stringIndexType	string	Dize uzaklığını ve uzunluğunu hesaplamak için kullanılan yöntem, olası değerler şunlardır: 'textElements', 'unicodeCodePoint', 'utf16CodeUnit' vb.
styles	DocumentStyle[]	Ayıklanan yazı tipi stilleri.

SmartCropsResult

Akıllı kırpma sonucu.

Name	Tür	Description
values	CropRegion[]	Görüntüyü kırpmak için önerilen bölgeler.

Tag

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.
name	string	Varlığın adı.

TagsResult

Güvenilirlik düzeyine sahip etiketlerin listesi.

Name	Tür	Description
values	Tag[]	Güvenilirlik düzeyine sahip etiketlerin listesi.

VisualFeature

İstenen görsel özellikleri: etiketler, nesneler, resim yazısı, denseCaptions, read, smartCrops, people. "model-name" parametresi belirtilmezse bu parametrenin belirtilmesi gerekir.

Name	Tür	Description
caption	string
denseCaptions	string
objects	string
people	string
read	string
smartCrops	string
tags	string

Aracılığıyla paylaş

Image Analysis - Analyze Stream

URI Parametreleri

İstek Gövdesi

Yanıtlar

Örnekler

AnalyzeImageFromImageStream_CustomModel

Örnek isteği

Örnek yanıt

Tanımlar

AdultMatch

AdultResult

BoundingBox

CaptionResult

CropRegion

DenseCaption

DenseCaptionsResult

DetectedObject

DetectedPerson

DocumentLine

DocumentPage

DocumentSpan

DocumentStyle

DocumentWord

ErrorResponse

ErrorResponseDetails

ErrorResponseInnerError

ImageAnalysisResult

ImageMetadataApiModel

ImagePredictionResult

ObjectsResult

PeopleResult

ReadResult

SmartCropsResult

Tag

TagsResult

VisualFeature

Ek kaynaklar