次の方法で共有


Analyze Image By Domain - Analyze Image By Domain

この操作は、ドメイン固有モデルを適用することで、画像内のコンテンツを認識します。 Computer Vision API によってサポートされるドメイン固有モデルの一覧は、/models GET 要求を使用して取得できます。 現時点で、この API によって提供されるドメイン固有モデルは著名人とランドマークです。 2 つの入力方法がサポートされています。(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 パラメーター

名前 / 必須 説明
Endpoint
path True

string

サポートされている Cognitive Services エンドポイント。

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" です。

正規表現パターン: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$

要求ヘッダー

名前 必須 説明
Ocp-Apim-Subscription-Key True

string

要求本文

名前 必須 説明
url True

string

イメージのパブリックに到達可能な URL。

応答

名前 説明
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
      }
    ]
  }
}

定義

名前 説明
ComputerVisionError

API 要求エラー。

ComputerVisionErrorCodes

エラー コード。

ComputerVisionErrorResponse

API エラー応答。

ComputerVisionInnerError

API 要求エラーの詳細。

ComputerVisionInnerErrorCodeValue

エラー コード。

DomainModelResults

追加のメタデータを含む特定のドメイン モデルを使用した画像分析の結果。

ImageMetadata

イメージ メタデータ。

ImageUrl

ComputerVisionError

API 要求エラー。

名前 説明
code

ComputerVisionErrorCodes

エラー コード。

innererror

ComputerVisionInnerError

内部エラーには、より具体的な情報が含まれています。

message

string

サービスによって報告されたエラーを説明するメッセージ。

ComputerVisionErrorCodes

エラー コード。

名前 説明
InternalServerError

string

InvalidArgument

string

InvalidRequest

string

ServiceUnavailable

string

ComputerVisionErrorResponse

API エラー応答。

名前 説明
error

ComputerVisionError

エラーの内容。

ComputerVisionInnerError

API 要求エラーの詳細。

名前 説明
code

ComputerVisionInnerErrorCodeValue

エラー コード。

message

string

エラー メッセージ。

ComputerVisionInnerErrorCodeValue

エラー コード。

名前 説明
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

追加のメタデータを含む特定のドメイン モデルを使用した画像分析の結果。

名前 説明
metadata

ImageMetadata

イメージ メタデータ。

modelVersion

string

AI モデルのバージョン。

requestId

string

REST API 要求の ID。

ImageMetadata

イメージ メタデータ。

名前 説明
format

string

イメージ形式。

height

integer

画像の高さ (ピクセル単位)。

width

integer

画像の幅 (ピクセル単位)。

ImageUrl

名前 説明
url

string

イメージのパブリックに到達可能な URL。