你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Detect Objects In Stream - Detect Objects In Stream

对指定的图像执行对象检测。 支持两种输入法 -- (1) 上传图像或 (2) 指定图像 URL。 成功响应将以 JSON 格式返回。 如果请求失败,响应将包含错误代码和一条消息,以帮助了解出错的内容。

POST {Endpoint}/vision/v3.1/detect

URI 参数

Name In Required Type Description
Endpoint
path True
  • string

支持的认知服务终结点。

请求头

Media Types: "application/octet-stream", "multipart/form-data"

Name Required Type Description
Ocp-Apim-Subscription-Key True
  • string

请求正文

Media Types: "application/octet-stream", "multipart/form-data"

Name Type Description
Image
  • object

图像流。

响应

Name Type Description
200 OK

响应包括 JSON 格式的检测到的对象。

Other Status Codes

错误响应。

安全性

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

示例

Successful DetectObjects request

Sample Request

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


"{binary}"

Sample Response

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

定义

BoundingRect

图像中某个区域的边界框。

ComputerVisionError

有关 API 请求错误的详细信息。

ComputerVisionErrorCodes

错误代码。

DetectedObject

图像中检测到的对象。

DetectResult

DetectImage 调用的结果。

ImageMetadata

图像元数据。

ObjectHierarchy

图像中检测到的对象。

BoundingRect

图像中某个区域的边界框。

Name Type Description
h
  • integer

从区域左上角测量的高度(以像素为单位)。

w
  • integer

从区域的左上角测量的宽度(以像素为单位)。

x
  • integer

区域左上角的 X 坐标(以像素为单位)。

y
  • integer

区域左上角的 Y 坐标(以像素为单位)。

ComputerVisionError

有关 API 请求错误的详细信息。

Name Type Description
code

错误代码。

message
  • string

说明服务报告的错误的消息。

requestId
  • string

唯一请求标识符。

ComputerVisionErrorCodes

错误代码。

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

DetectedObject

图像中检测到的对象。

Name Type Description
confidence
  • number

在图像中观察到对象的置信度分数,值为 0 到 1。

object
  • string

对象的标签。

parent

父对象,从分类角度。 父对象是此对象的更通用形式。 例如,“斗牛犬”的父级为“狗”。

rectangle

检测到对象的近似位置。

DetectResult

DetectImage 调用的结果。

Name Type Description
metadata

图像元数据。

objects

检测到的对象数组。

requestId
  • string

REST API 请求的 ID。

ImageMetadata

图像元数据。

Name Type Description
format
  • string

图像格式。

height
  • integer

图像高度(以像素为单位)。

width
  • integer

图像宽度(以像素为单位)。

ObjectHierarchy

图像中检测到的对象。

Name Type Description
confidence
  • number

在图像中观察到对象的置信度分数,值为 0 到 1。

object
  • string

对象的标签。

parent

父对象,从分类角度。 父对象是此对象的更通用形式。 例如,“斗牛犬”的父级为“狗”。