Udostępnij za pośrednictwem


Analyze Image By Domain - Analyze Image By Domain

Ta operacja rozpoznaje zawartość na obrazie przez zastosowanie modelu specyficznego dla domeny. Listę modeli specyficznych dla domeny obsługiwanych przez interfejs API przetwarzanie obrazów można pobrać przy użyciu żądania GET /models. Obecnie interfejs API udostępnia następujące modele specyficzne dla domeny: gwiazdy, punkty orientacyjne. Obsługiwane są dwie metody wejściowe — (1) Przekazywanie obrazu lub (2) określanie adresu URL obrazu. Pomyślna odpowiedź zostanie zwrócona w formacie JSON. Jeśli żądanie nie powiedzie się, odpowiedź będzie zawierać kod błędu i komunikat, który pomoże zrozumieć, co poszło nie tak.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
Endpoint
path True

string

Obsługiwane punkty końcowe usług Cognitive Services.

model
path True

string

Zawartość specyficzna dla domeny do rozpoznania.

language
query

string

Żądany język do generowania danych wyjściowych. Jeśli ten parametr nie zostanie określony, wartość domyślna to "en". Zobacz https://aka.ms/cv-languages listę obsługiwanych języków.

model-version
query

string

Opcjonalny parametr określający wersję modelu AI. Akceptowane wartości to: "latest", "2021-04-01", "2021-05-01". Wartość domyślna to "latest".

Wzorzec wyrażenia regularnego: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$

Nagłówek żądania

Nazwa Wymagane Typ Opis
Ocp-Apim-Subscription-Key True

string

Treść żądania

Nazwa Wymagane Typ Opis
url True

string

Publicznie dostępny adres URL obrazu.

Odpowiedzi

Nazwa Typ Opis
200 OK

DomainModelResults

Wynik analizy oparty na modelu domeny.

Other Status Codes

ComputerVisionErrorResponse

Odpowiedź na błąd.

Zabezpieczenia

Ocp-Apim-Subscription-Key

Typ: apiKey
W: header

Przykłady

Successful AnalyzeImageByDomain request

Przykładowe żądanie

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


{
  "url": "{url}"
}

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
ComputerVisionError

Błąd żądania interfejsu API.

ComputerVisionErrorCodes

Kod błędu.

ComputerVisionErrorResponse

Odpowiedź na błąd interfejsu API.

ComputerVisionInnerError

Szczegółowe informacje o błędzie żądania interfejsu API.

ComputerVisionInnerErrorCodeValue

Kod błędu.

DomainModelResults

Wynik analizy obrazu przy użyciu określonego modelu domeny, w tym dodatkowe metadane.

ImageMetadata

Metadane obrazu.

ImageUrl

ComputerVisionError

Błąd żądania interfejsu API.

Nazwa Typ Opis
code

ComputerVisionErrorCodes

Kod błędu.

innererror

ComputerVisionInnerError

Błąd wewnętrzny zawiera bardziej szczegółowe informacje.

message

string

Komunikat wyjaśniający błąd zgłoszony przez usługę.

ComputerVisionErrorCodes

Kod błędu.

Nazwa Typ Opis
InternalServerError

string

InvalidArgument

string

InvalidRequest

string

ServiceUnavailable

string

ComputerVisionErrorResponse

Odpowiedź na błąd interfejsu API.

Nazwa Typ Opis
error

ComputerVisionError

Zawartość błędu.

ComputerVisionInnerError

Szczegółowe informacje o błędzie żądania interfejsu API.

Nazwa Typ Opis
code

ComputerVisionInnerErrorCodeValue

Kod błędu.

message

string

Komunikat o błędzie.

ComputerVisionInnerErrorCodeValue

Kod błędu.

Nazwa Typ Opis
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

Wynik analizy obrazu przy użyciu określonego modelu domeny, w tym dodatkowe metadane.

Nazwa Typ Opis
metadata

ImageMetadata

Metadane obrazu.

modelVersion

string

Wersja modelu AI.

requestId

string

Identyfikator żądania interfejsu API REST.

ImageMetadata

Metadane obrazu.

Nazwa Typ Opis
format

string

Format obrazu.

height

integer

Wysokość obrazu w pikselach.

width

integer

Szerokość obrazu w pikselach.

ImageUrl

Nazwa Typ Opis
url

string

Publicznie dostępny adres URL obrazu.