Aracılığıyla paylaş


Analyze Image By Domain - Analyze Image By Domain

Bu işlem, etki alanına özgü bir model uygulayarak görüntüdeki içeriği tanır. Görüntü İşleme API tarafından desteklenen etki alanına özgü modellerin listesi /models GET isteği kullanılarak alınabilir. Api şu anda etki alanına özgü şu modelleri sağlamaktadır: ünlüler, yer işaretleri. İki giriş yöntemi desteklenir: (1) Görüntü karşıya yükleme veya (2) görüntü URL'si belirtme. 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/models/{model}/analyze
POST {Endpoint}/vision/v3.2/models/{model}/analyze?language={language}&model-version={model-version}

URI Parametreleri

Name İçinde Gerekli Tür Description
Endpoint
path True

string

Desteklenen Bilişsel Hizmetler uç noktaları.

model
path True

string

Tanınacak etki alanına özgü içerik.

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)?$

İ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

DomainModelResults

Etki alanı modeline göre analiz sonucu.

Other Status Codes

ComputerVisionErrorResponse

Hata yanıtı.

Güvenlik

Ocp-Apim-Subscription-Key

Tür: apiKey
İçinde: header

Örnekler

Successful AnalyzeImageByDomain request

Örnek isteği

POST https://westus.api.cognitive.microsoft.com/vision/v3.2/models/Celebrities/analyze


{
  "url": "{url}"
}

Örnek yanıt

{
  "requestId": "f0027b4b-dc0d-4082-9228-1545ed246b03",
  "metadata": {
    "width": 1500,
    "height": 1000,
    "format": "Jpeg"
  },
  "modelVersion": "2021-04-01",
  "result": {
    "celebrities": [
      {
        "name": "Satya Nadella",
        "faceRectangle": {
          "left": 597,
          "top": 162,
          "width": 248,
          "height": 248
        },
        "confidence": 0.999028444
      }
    ]
  }
}

Tanımlar

Name Description
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.

DomainModelResults

Ek meta veriler de dahil olmak üzere belirli bir etki alanı modeli kullanılarak görüntü analizinin sonucu.

ImageMetadata

Görüntü meta verileri.

ImageUrl

ComputerVisionError

API isteği hatası.

Name Tür Description
code

ComputerVisionErrorCodes

Hata kodu.

innererror

ComputerVisionInnerError

İç hata daha belirgin 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

DomainModelResults

Ek meta veriler de dahil olmak üzere belirli bir etki alanı modeli kullanılarak görüntü analizinin sonucu.

Name Tür Description
metadata

ImageMetadata

Görüntü meta verileri.

modelVersion

string

Yapay zeka modelinin sürümü.

requestId

string

REST API isteğinin kimliği.

ImageMetadata

Görüntü meta verileri.

Name Tür Description
format

string

Görüntü biçimi.

height

integer

Piksel cinsinden görüntü yüksekliği.

width

integer

Piksel cinsinden görüntü genişliği.

ImageUrl

Name Tür Description
url

string

Görüntünün genel olarak erişilebilen URL'si.