次の方法で共有

Detect Objects - Detect Objects

  • リファレンス
サービス:
Azure AI Services
API バージョン:
3.2

指定した画像に対してオブジェクト検出を実行します。 2 つの入力方法がサポートされています。(1) イメージのアップロードまたは (2) イメージ URL の指定。 成功した応答は JSON で返されます。 要求が失敗した場合、応答にはエラー コードと、何が問題が発生したかを理解するのに役立つメッセージが含まれます。

POST {Endpoint}/vision/v3.2/detect
省略可能なパラメーターを含む: 
POST {Endpoint}/vision/v3.2/detect?model-version={model-version}

URI パラメーター

名前 / 必須 型 説明
Endpoint
 path True

string

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

string

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

AI モデルのバージョンを指定する省略可能なパラメーター。 指定できる値は、"latest"、"2021-04-01"、"2021-05-01" です。 既定値は "latest" です。

要求ヘッダー

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

string

要求本文

名前 必須 型 説明
url True

string

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

応答

名前 型 説明
200 OK

DetectResult

応答には、検出されたオブジェクトが JSON 形式で含まれます。
Other Status Codes

ComputerVisionErrorResponse

エラー応答。

セキュリティ

Ocp-Apim-Subscription-Key

型: apiKey
/: header

例

Successful DetectObjects request

要求のサンプル

POST https://westus.api.cognitive.microsoft.com/vision/v3.2/detect


{
  "url": "{url}"
}

応答のサンプル

状態コード:
200 
{
  "objects": [
    {
      "rectangle": {
        "x": 0,
        "y": 0,
        "w": 50,
        "h": 50
      },
      "object": "tree",
      "confidence": 0.9,
      "parent": {
        "object": "plant",
        "confidence": 0.95
      }
    }
  ],
  "requestId": "1ad0e45e-b7b4-4be3-8042-53be96103337",
  "metadata": {
    "width": 100,
    "height": 100,
    "format": "Jpeg"
  },
  "modelVersion": "2021-04-01"
}

定義

名前 説明
BoundingRect

イメージ内の領域の境界ボックス。
ComputerVisionError

API 要求エラー。
ComputerVisionErrorCodes

エラー コード。
ComputerVisionErrorResponse

API エラー応答。
ComputerVisionInnerError

API 要求エラーの詳細。
ComputerVisionInnerErrorCodeValue

エラー コード。
DetectedObject

画像内で検出されたオブジェクト。
DetectResult

DetectImage 呼び出しの結果。
ImageMetadata

イメージ メタデータ。
ImageUrl
ObjectHierarchy

画像内で検出されたオブジェクト。

BoundingRect

Object

イメージ内の領域の境界ボックス。

名前 型 説明
h

integer (int32)

領域の左上のポイントからピクセル単位で測定された高さ。
w

integer (int32)

領域の左上のポイントからピクセル単位で測定された幅。
x

integer (int32)

領域の左上のポイントの X 座標 (ピクセル単位)。
y

integer (int32)

領域の左上のポイントの Y 座標 (ピクセル単位)。

ComputerVisionError

Object

API 要求エラー。

名前 型 説明
code

ComputerVisionErrorCodes

エラー コード。
innererror

ComputerVisionInnerError

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

string

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

ComputerVisionErrorCodes

列挙

エラー コード。

値 説明
InternalServerError
InvalidArgument
InvalidRequest
ServiceUnavailable

ComputerVisionErrorResponse

Object

API エラー応答。

名前 型 説明
error

ComputerVisionError

エラーの内容。

ComputerVisionInnerError

Object

API 要求エラーの詳細。

名前 型 説明
code

ComputerVisionInnerErrorCodeValue

エラー コード。
message

string

エラーメッセージ。

ComputerVisionInnerErrorCodeValue

列挙

エラー コード。

値 説明
BadArgument
CancelledRequest
DetectFaceError
FailedToProcess
InternalServerError
InvalidDetails
InvalidImageFormat
InvalidImageSize
InvalidImageUrl
InvalidModel
InvalidThumbnailSize
NotSupportedFeature
NotSupportedImage
NotSupportedLanguage
NotSupportedVisualFeature
StorageException
Timeout
Unspecified
UnsupportedMediaType

DetectedObject

Object

画像内で検出されたオブジェクト。

名前 型 説明
confidence

number (double)

画像内の物体を観察した信頼度スコアは、0から1の範囲の値として得られる。
object

string

オブジェクトのラベル。
parent

ObjectHierarchy

分類の観点から見た親オブジェクト。 親オブジェクトは、このオブジェクトのより汎用的な形式です。 たとえば、'bulldog' の親は 'dog' になります。
rectangle

BoundingRect

検出されたオブジェクトのおおよその位置。

DetectResult

Object

DetectImage 呼び出しの結果。

名前 型 説明
metadata

ImageMetadata

イメージ メタデータ。
modelVersion

string

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

AI モデルのバージョン。
objects

DetectedObject[]

検出されたオブジェクトの配列。
requestId

string

REST API 要求の ID。

ImageMetadata

Object

イメージ メタデータ。

名前 型 説明
format

string

イメージ形式。
height

integer (int32)

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

integer (int32)

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

ImageUrl

Object
名前 型 説明
url

string

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

ObjectHierarchy

Object

画像内で検出されたオブジェクト。

名前 型 説明
confidence

number (double)

画像内の物体を観察した信頼度スコアは、0から1の範囲の値として得られる。
object

string

オブジェクトのラベル。
parent

ObjectHierarchy

分類の観点から見た親オブジェクト。 親オブジェクトは、このオブジェクトのより汎用的な形式です。 たとえば、'bulldog' の親は 'dog' になります。