Detect Objects In Stream - Detect Objects In Stream

Serviço:

Azure AI Services

Versão da API:

3.2

Executa a detecção de objetos na imagem especificada. Há suporte para dois métodos de entrada : (1) Carregar uma imagem ou (2) especificar uma URL de imagem. Uma resposta bem-sucedida será retornada no JSON. Se a solicitação falhar, a resposta conterá um código de erro e uma mensagem para ajudar a entender o que deu errado.

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

Com parâmetros opcionais:

POST {Endpoint}/vision/v3.2/detect?overload=stream&model-version={model-version}

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
Endpoint	path	True	string	Pontos de extremidade dos Serviços Cognitivos com suporte.
model-version	query		string pattern: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$	Parâmetro opcional para especificar a versão do modelo de IA. Os valores aceitos são: "latest", "2021-04-01", "2021-05-01". O padrão é "mais recente".

Cabeçalho da solicitação

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

Nome	Obrigatório	Tipo	Description
Ocp-Apim-Subscription-Key	True	string

Corpo da solicitação

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

Nome	Tipo	Description
Image	object (file)	Um fluxo de imagem.

Respostas

Nome	Tipo	Description
200 OK	DetectResult	A resposta inclui os objetos detectados no formato JSON.
Other Status Codes	ComputerVisionErrorResponse	Resposta de erro.

Segurança

Ocp-Apim-Subscription-Key

Tipo: apiKey
Em: header

Exemplos

Successful DetectObjects request

Solicitação de exemplo

HTTP

POST https://westus.api.cognitive.microsoft.com/vision/v3.2/detect?overload=stream


"{binary}"

Resposta de exemplo

Código de status:

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

Definições

Nome	Description
BoundingRect	Uma caixa delimitadora para uma área dentro de uma imagem.
ComputerVisionError	O erro de solicitação de API.
ComputerVisionErrorCodes	O código de erro.
ComputerVisionErrorResponse	A resposta de erro da API.
ComputerVisionInnerError	Detalhes sobre o erro de solicitação de API.
ComputerVisionInnerErrorCodeValue	O código de erro.
DetectedObject	Um objeto detectado em uma imagem.
DetectResult	Resultado de uma chamada do DetectImage.
ImageMetadata	Metadados de imagem.
ObjectHierarchy	Um objeto detectado dentro de uma imagem.

BoundingRect

Objeto

Uma caixa delimitadora para uma área dentro de uma imagem.

Nome	Tipo	Description
h	integer (int32)	Altura medida do ponto superior esquerdo da área, em pixels.
w	integer (int32)	Largura medida do ponto superior esquerdo da área, em pixels.
x	integer (int32)	Coordenada X do ponto superior esquerdo da área, em pixels.
y	integer (int32)	Coordenada Y do ponto superior esquerdo da área, em pixels.

ComputerVisionError

Objeto

O erro de solicitação de API.

Nome	Tipo	Description
code	ComputerVisionErrorCodes	O código de erro.
innererror	ComputerVisionInnerError	O erro interno contém informações mais específicas.
message	string	Uma mensagem explicando o erro relatado pelo serviço.

ComputerVisionErrorCodes

Enumeração

O código de erro.

Valor	Description
InvalidRequest
InvalidArgument
InternalServerError
ServiceUnavailable

ComputerVisionErrorResponse

Objeto

A resposta de erro da API.

Nome	Tipo	Description
error	ComputerVisionError	Conteúdo de erro.

ComputerVisionInnerError

Objeto

Detalhes sobre o erro de solicitação de API.

Nome	Tipo	Description
code	ComputerVisionInnerErrorCodeValue	O código de erro.
message	string	Mensagem de erro.

ComputerVisionInnerErrorCodeValue

Enumeração

O código de erro.

Valor	Description
InvalidImageFormat
UnsupportedMediaType
InvalidImageUrl
NotSupportedFeature
NotSupportedImage
Timeout
InternalServerError
InvalidImageSize
BadArgument
DetectFaceError
NotSupportedLanguage
InvalidThumbnailSize
InvalidDetails
InvalidModel
CancelledRequest
NotSupportedVisualFeature
FailedToProcess
Unspecified
StorageException

DetectedObject

Objeto

Um objeto detectado em uma imagem.

Nome	Tipo	Description
confidence	number (double)	Pontuação de confiança de ter observado o objeto na imagem, como um valor que varia de 0 a 1.
object	string	Rótulo para o objeto.
parent	ObjectHierarchy	O objeto pai, de uma perspectiva de taxonomia. O objeto pai é uma forma mais genérica desse objeto. Por exemplo, um "buldogue" teria um pai de "cachorro".
rectangle	BoundingRect	Localização aproximada do objeto detectado.

DetectResult

Objeto

Resultado de uma chamada do DetectImage.

Nome	Tipo	Description
metadata	ImageMetadata	Metadados de imagem.
modelVersion	string pattern: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$	Versão do modelo de IA.
objects	DetectedObject[]	Uma matriz de objetos detectados.
requestId	string	ID da solicitação da API REST.

ImageMetadata

Objeto

Metadados de imagem.

Nome	Tipo	Description
format	string	Formato de imagem.
height	integer (int32)	Altura da imagem, em pixels.
width	integer (int32)	Largura da imagem, em pixels.

ObjectHierarchy

Objeto

Um objeto detectado dentro de uma imagem.

Nome	Tipo	Description
confidence	number (double)	Pontuação de confiança de ter observado o objeto na imagem, como um valor que varia de 0 a 1.
object	string	Rótulo para o objeto.
parent	ObjectHierarchy	O objeto pai, de uma perspectiva de taxonomia. O objeto pai é uma forma mais genérica desse objeto. Por exemplo, um "buldogue" teria um pai de "cachorro".