Image Operations - Analyze Image

Hizmet:

Azure AI Services

API Sürümü:

2024-09-01

Görüntüyü Analiz Et
Zararlı olabilecek görüntü içeriğini analiz etmek için zaman uyumlu bir API. Şu anda dört kategoriyi desteklemektedir: Nefret, SelfHarm, Cinsel ve Şiddet.

POST {endpoint}/contentsafety/image:analyze?api-version=2024-09-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string (uri)	Desteklenen Bilişsel Hizmetler uç noktaları (protokol ve ana bilgisayar adı, örneğin: https://< resource-name.cognitiveservices.azure.com>).
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

Name	Gerekli	Tür	Description
image	True	ImageData	Analiz edilecek görüntü.
categories		ImageCategory[]	Kategoriler analiz edilir. Atanmamışlarsa, kategoriler için varsayılan bir çözümleme sonuçları kümesi döndürülür.
outputType		AnalyzeImageOutputType	Bu, görüntü çözümleme çıkışının türünü ifade eder. Hiçbir değer atanmazsa, varsayılan değer "FourSeverityLevels" olur.

Yanıtlar

Name	Tür	Description
200 OK	AnalyzeImageResult	İstek başarılı oldu.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Beklenmeyen bir hata yanıtı. Üst Bilgiler x-ms-error-code: string

Güvenlik

Ocp-Apim-Subscription-Key

Tür: apiKey
İçinde: header

OAuth2Auth

Tür: oauth2
Akış: application
Belirteç URL'si: https://login.microsoftonline.com/common/oauth2/v2.0/token

Kapsamlar

Name	Description
https://cognitiveservices.azure.com/.default

Örnekler

Analyze Image

Örnek isteği

HTTP

POST {endpoint}/contentsafety/image:analyze?api-version=2024-09-01

{
  "image": {
    "content": "Y29udGVudDE="
  }
}

Örnek yanıt

Durum kodu:

200

{
  "categoriesAnalysis": [
    {
      "category": "Hate",
      "severity": 0
    },
    {
      "category": "SelfHarm",
      "severity": 0
    },
    {
      "category": "Sexual",
      "severity": 0
    },
    {
      "category": "Violence",
      "severity": 2
    }
  ]
}

Tanımlar

Name	Description
AnalyzeImageOptions	Görüntü analizi isteği.
AnalyzeImageOutputType	Bu, görüntü çözümleme çıkışının türünü ifade eder. Hiçbir değer atanmazsa, varsayılan değer "FourSeverityLevels" olur.
AnalyzeImageResult	Görüntü analizi yanıtı.
Azure.Core.Foundations.Error	Hata nesnesi.
Azure.Core.Foundations.ErrorResponse	Hata ayrıntılarını içeren bir yanıt.
Azure.Core.Foundations.InnerError	Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.
ImageCategoriesAnalysis	Görüntü çözümleme sonucu.
ImageCategory	Görüntü içerik analizinde desteklenen zarar kategorisi.
ImageData	Görüntü base64 kodlanmış bayt veya blob URL'si olabilir. Bu seçeneklerden yalnızca birini seçebilirsiniz. Her ikisi de sağlanırsa istek reddedilir. En büyük görüntü boyutu 2048 x 2048 pikseldir ve en düşük görüntü boyutu 50 x 50 piksel iken 4 MB'ı aşmamalıdır.

AnalyzeImageOptions

Nesne

Görüntü analizi isteği.

Name	Tür	Default value	Description
categories	ImageCategory[]		Kategoriler analiz edilir. Atanmamışlarsa, kategoriler için varsayılan bir çözümleme sonuçları kümesi döndürülür.
image	ImageData		Analiz edilecek görüntü.
outputType	AnalyzeImageOutputType	FourSeverityLevels	Bu, görüntü çözümleme çıkışının türünü ifade eder. Hiçbir değer atanmazsa, varsayılan değer "FourSeverityLevels" olur.

AnalyzeImageOutputType

Numaralandırma

Bu, görüntü çözümleme çıkışının türünü ifade eder. Hiçbir değer atanmazsa, varsayılan değer "FourSeverityLevels" olur.

Değer	Description
FourSeverityLevels	Dört düzeyde çıkış önem derecesi, değer 0,2,4,6 olabilir.

AnalyzeImageResult

Nesne

Görüntü analizi yanıtı.

Name	Tür	Description
categoriesAnalysis	ImageCategoriesAnalysis[]	Kategoriler için analiz sonucu.

Azure.Core.Foundations.Error

Nesne

Hata nesnesi.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
details	Azure.Core.Foundations.Error[]	Bu bildirilen hataya yol açan belirli hatalar hakkında bir dizi ayrıntı.
innererror	Azure.Core.Foundations.InnerError	Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne.
message	string	Hatanın insan tarafından okunabilir bir gösterimi.
target	string	Hatanın hedefi.

Azure.Core.Foundations.ErrorResponse

Nesne

Hata ayrıntılarını içeren bir yanıt.

Name	Tür	Description
error	Azure.Core.Foundations.Error	Hata nesnesi.

Azure.Core.Foundations.InnerError

Nesne

Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
innererror	Azure.Core.Foundations.InnerError	İç hata.

ImageCategoriesAnalysis

Nesne

Görüntü çözümleme sonucu.

Name	Tür	Description
category	ImageCategory	Görüntü analizi kategorisi.
severity	integer (int32)	Değer, giriş içeriğinin önem derecesiyle artar. Bu alanın değeri, istekte belirtilen çıkış türüne göre belirlenir. Çıkış türü 'FourSeverityLevels' ve çıkış değeri 0, 2, 4, 6 olabilir.

ImageCategory

Numaralandırma

Görüntü içerik analizinde desteklenen zarar kategorisi.

Değer	Description
Hate	Image - Hate için zarar kategorisi.
SelfHarm	Image - SelfHarm için zarar kategorisi.
Sexual	Image için zarar kategorisi - Cinsel.
Violence	Görüntü - Şiddet için zarar kategorisi.

ImageData

Nesne

Görüntü base64 kodlanmış bayt veya blob URL'si olabilir. Bu seçeneklerden yalnızca birini seçebilirsiniz. Her ikisi de sağlanırsa istek reddedilir. En büyük görüntü boyutu 2048 x 2048 pikseldir ve en düşük görüntü boyutu 50 x 50 piksel iken 4 MB'ı aşmamalıdır.

Name	Tür	Description
blobUrl	string (uri)	Görüntünün blob url'si.
content	string (byte)	Görüntünün Base64 kodlaması.