共用方式為


Analyze Image By Domain - Analyze Image By Domain

此作業會套用特定領域模型,以辨識影像內的內容。 您可以使用 /models GET 要求擷取 電腦視覺 API 所支援的網域特定模型清單。 目前,API 提供下列領域特定模型:名人、地標。 支援兩個輸入方法: (1) 上傳影像或 (2) 指定影像 URL。 成功回應會在 JSON 中傳回。 如果要求失敗,回應將包含錯誤碼和訊息,以協助了解發生錯誤的原因。

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

URI 參數

名稱 位於 必要 類型 Description
Endpoint
path True

string

支援的認知服務端點。

model
path True

string

要辨識的網域特定內容。

language
query

string

輸出產生所需的語言。 如果未指定此屬性,則預設值為 "en"。 如需支援的語言清單,請參閱 https://aka.ms/cv-languages

model-version
query

string

選擇性參數,可指定 AI 模型的版本。 接受的值包括:“latest”、“2021-04-01”、“2021-05-01”。 預設為 「latest」。。

Regex 模式: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$

要求標頭

名稱 必要 類型 Description
Ocp-Apim-Subscription-Key True

string

要求本文

名稱 必要 類型 Description
url True

string

影像的可公開連線 URL。

回應

名稱 類型 Description
200 OK

DomainModelResults

以領域模型為基礎的分析結果。

Other Status Codes

ComputerVisionErrorResponse

錯誤回應。

安全性

Ocp-Apim-Subscription-Key

類型: apiKey
位於: header

範例

Successful AnalyzeImageByDomain request

範例要求

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


{
  "url": "{url}"
}

範例回覆

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

定義

名稱 Description
ComputerVisionError

API 要求錯誤。

ComputerVisionErrorCodes

錯誤碼。

ComputerVisionErrorResponse

API 錯誤回應。

ComputerVisionInnerError

API 要求錯誤的詳細數據。

ComputerVisionInnerErrorCodeValue

錯誤碼。

DomainModelResults

使用特定領域模型進行影像分析的結果,包括其他元數據。

ImageMetadata

影像元數據。

ImageUrl

ComputerVisionError

API 要求錯誤。

名稱 類型 Description
code

ComputerVisionErrorCodes

錯誤碼。

innererror

ComputerVisionInnerError

內部錯誤包含更具體的資訊。

message

string

說明服務所報告錯誤的訊息。

ComputerVisionErrorCodes

錯誤碼。

名稱 類型 Description
InternalServerError

string

InvalidArgument

string

InvalidRequest

string

ServiceUnavailable

string

ComputerVisionErrorResponse

API 錯誤回應。

名稱 類型 Description
error

ComputerVisionError

錯誤內容。

ComputerVisionInnerError

API 要求錯誤的詳細數據。

名稱 類型 Description
code

ComputerVisionInnerErrorCodeValue

錯誤碼。

message

string

錯誤訊息。

ComputerVisionInnerErrorCodeValue

錯誤碼。

名稱 類型 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

使用特定領域模型進行影像分析的結果,包括其他元數據。

名稱 類型 Description
metadata

ImageMetadata

影像元數據。

modelVersion

string

AI 模型的版本。

requestId

string

REST API 要求的標識碼。

ImageMetadata

影像元數據。

名稱 類型 Description
format

string

影像格式。

height

integer

影像高度,以像素為單位。

width

integer

影像寬度,以像素為單位。

ImageUrl

名稱 類型 Description
url

string

影像的可公開連線 URL。