Megosztás a következőn keresztül:


Analyze Image By Domain - Analyze Image By Domain

Ez a művelet egy tartományspecifikus modell alkalmazásával felismeri a képeken belüli tartalmakat. A Computer Vision API által támogatott tartományspecifikus modellek listája lekérhető a /models GET kéréssel. Az API jelenleg a következő tartományspecifikus modelleket biztosítja: hírességek, nevezetességek. Két bemeneti módszer támogatott – (1) Kép feltöltése vagy (2) kép URL-címének megadása. A rendszer sikeres választ ad vissza a JSON-ban. Ha a kérés sikertelen volt, a válasz tartalmaz egy hibakódot és egy üzenetet, amely segít megérteni, hogy mi történt.

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

URI-paraméterek

Name In Kötelező Típus Description
Endpoint
path True

string

Támogatott Cognitive Services-végpontok.

model
path True

string

A felismerni kívánt tartományspecifikus tartalom.

language
query

string

A kimeneti létrehozás kívánt nyelve. Ha ez a paraméter nincs megadva, az alapértelmezett érték az "en". A támogatott nyelvek listáját itt találja https://aka.ms/cv-languages .

model-version
query

string

Nem kötelező paraméter az AI-modell verziójának megadásához. Az elfogadott értékek a következők: "latest", "2021-04-01", "2021-05-01". Alapértelmezés szerint a "legújabb".

Reguláris kifejezési minta: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$

Kérelem fejléce

Name Kötelező Típus Description
Ocp-Apim-Subscription-Key True

string

Kérelem törzse

Name Kötelező Típus Description
url True

string

Egy kép nyilvánosan elérhető URL-címe.

Válaszok

Name Típus Description
200 OK

DomainModelResults

Elemzési eredmény a tartománymodell alapján.

Other Status Codes

ComputerVisionErrorResponse

Hibaválasz.

Biztonság

Ocp-Apim-Subscription-Key

Típus: apiKey
In: header

Példák

Successful AnalyzeImageByDomain request

Mintakérelem

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


{
  "url": "{url}"
}

Mintaválasz

{
  "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
      }
    ]
  }
}

Definíciók

Name Description
ComputerVisionError

Az API-kérés hibája.

ComputerVisionErrorCodes

A hibakód.

ComputerVisionErrorResponse

Az API-hibaválasz.

ComputerVisionInnerError

Az API-kérelem hibájának részletei.

ComputerVisionInnerErrorCodeValue

A hibakód.

DomainModelResults

Egy adott tartománymodellt használó képelemzés eredménye, beleértve a további metaadatokat is.

ImageMetadata

Kép metaadatai.

ImageUrl

ComputerVisionError

Az API-kérés hibája.

Name Típus Description
code

ComputerVisionErrorCodes

A hibakód.

innererror

ComputerVisionInnerError

A belső hiba konkrétabb információkat tartalmaz.

message

string

A szolgáltatás által jelentett hibát magyarázó üzenet.

ComputerVisionErrorCodes

A hibakód.

Name Típus Description
InternalServerError

string

InvalidArgument

string

InvalidRequest

string

ServiceUnavailable

string

ComputerVisionErrorResponse

Az API-hibaválasz.

Name Típus Description
error

ComputerVisionError

Hiba tartalma.

ComputerVisionInnerError

Az API-kérelem hibájának részletei.

Name Típus Description
code

ComputerVisionInnerErrorCodeValue

A hibakód.

message

string

Hibaüzenet.

ComputerVisionInnerErrorCodeValue

A hibakód.

Name Típus 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

Egy adott tartománymodellt használó képelemzés eredménye, beleértve a további metaadatokat is.

Name Típus Description
metadata

ImageMetadata

Kép metaadatai.

modelVersion

string

Az AI-modell verziója.

requestId

string

A REST API-kérés azonosítója.

ImageMetadata

Kép metaadatai.

Name Típus Description
format

string

Képformátum.

height

integer

Kép magassága képpontban.

width

integer

Képszélesség képpontban.

ImageUrl

Name Típus Description
url

string

Egy kép nyilvánosan elérhető URL-címe.