Sdílet prostřednictvím


Analyze Image By Domain - Analyze Image By Domain

Tato operace rozpozná obsah v imagi použitím modelu specifického pro doménu. Seznam modelů specifických pro doménu, které podporuje rozhraní API Počítačové zpracování obrazu, je možné načíst pomocí požadavku GET /models. V současné době rozhraní API poskytuje následující modely specifické pro doménu: celebrity, orientační body. Podporují se dvě metody zadávání – (1) nahrání obrázku nebo (2) zadání adresy URL obrázku. Úspěšná odpověď se vrátí ve formátu JSON. Pokud požadavek selhal, odpověď bude obsahovat kód chyby a zprávu, která vám pomůže pochopit, co se nepovedlo.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
Endpoint
path True

string

Podporované koncové body služeb Cognitive Services

model
path True

string

Obsah specifický pro doménu, který se má rozpoznat.

language
query

string

Požadovaný jazyk pro generování výstupu. Pokud tento parametr není zadaný, výchozí hodnota je "en". Seznam podporovaných jazyků najdete v tématu https://aka.ms/cv-languages .

model-version
query

string

Volitelný parametr pro určení verze modelu AI. Přípustné hodnoty jsou: "latest", "2021-04-01", "2021-05-01". Výchozí hodnota je "latest".

Vzor regulárního výrazu: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$

Hlavička požadavku

Name Vyžadováno Typ Description
Ocp-Apim-Subscription-Key True

string

Text požadavku

Name Vyžadováno Typ Description
url True

string

Veřejně dostupná adresa URL obrázku

Odpovědi

Name Typ Description
200 OK

DomainModelResults

Výsledek analýzy na základě doménového modelu.

Other Status Codes

ComputerVisionErrorResponse

Chybová odpověď.

Zabezpečení

Ocp-Apim-Subscription-Key

Typ: apiKey
V: header

Příklady

Successful AnalyzeImageByDomain request

Ukázkový požadavek

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


{
  "url": "{url}"
}

Ukázková odpověď

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

Definice

Name Description
ComputerVisionError

Chyba požadavku rozhraní API

ComputerVisionErrorCodes

Kód chyby

ComputerVisionErrorResponse

Odpověď na chybu rozhraní API

ComputerVisionInnerError

Podrobnosti o chybě požadavku rozhraní API

ComputerVisionInnerErrorCodeValue

Kód chyby

DomainModelResults

Výsledek analýzy obrázků pomocí konkrétního doménového modelu, včetně dalších metadat

ImageMetadata

Metadata obrázků.

ImageUrl

ComputerVisionError

Chyba požadavku rozhraní API

Name Typ Description
code

ComputerVisionErrorCodes

Kód chyby

innererror

ComputerVisionInnerError

Vnitřní chyba obsahuje konkrétnější informace.

message

string

Zpráva vysvětlující chybu hlášenou službou

ComputerVisionErrorCodes

Kód chyby

Name Typ Description
InternalServerError

string

InvalidArgument

string

InvalidRequest

string

ServiceUnavailable

string

ComputerVisionErrorResponse

Odpověď na chybu rozhraní API

Name Typ Description
error

ComputerVisionError

Obsah chyby.

ComputerVisionInnerError

Podrobnosti o chybě požadavku rozhraní API

Name Typ Description
code

ComputerVisionInnerErrorCodeValue

Kód chyby

message

string

Chybová zpráva.

ComputerVisionInnerErrorCodeValue

Kód chyby

Name Typ 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

Výsledek analýzy obrázků pomocí konkrétního doménového modelu, včetně dalších metadat

Name Typ Description
metadata

ImageMetadata

Metadata obrázků.

modelVersion

string

Verze modelu AI.

requestId

string

ID požadavku rozhraní REST API

ImageMetadata

Metadata obrázků.

Name Typ Description
format

string

Formát obrázku.

height

integer

Výška obrázku v pixelech

width

integer

Šířka obrázku v pixelech

ImageUrl

Name Typ Description
url

string

Veřejně dostupná adresa URL obrázku