Compartilhar via


Get Area Of Interest In Stream - Get Area Of Interest In Stream

Essa operação retorna uma caixa delimitadora em torno da área mais importante da 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 determinar o que deu errado. Após a falha, o código de erro e uma mensagem de erro são retornados. O código de erro pode ser um de InvalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, FailedToProcess, Timeout ou InternalServerError.

POST {Endpoint}/vision/v3.2/areaOfInterest
POST {Endpoint}/vision/v3.2/areaOfInterest?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

AreaOfInterestResult

A resposta inclui a área de interesse extraída no formato JSON.

Other Status Codes

ComputerVisionErrorResponse

Resposta de erro.

Segurança

Ocp-Apim-Subscription-Key

Tipo: apiKey
Em: header

Exemplos

Successful GetAreaOfInterest request

Solicitação de exemplo

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


"{binary}"

Resposta de exemplo

{
  "areaOfInterest": {
    "h": 951,
    "w": 950,
    "x": 160,
    "y": 0
  },
  "requestId": "ed2de1c6-fb55-4686-b0da-4da6e05d283f",
  "metadata": {
    "format": "Jpeg",
    "height": 951,
    "width": 1378
  },
  "modelVersion": "2021-04-01"
}

Definições

Nome Description
AreaOfInterestResult

Resultado da operação AreaOfInterest.

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.

ImageMetadata

Metadados de imagem.

AreaOfInterestResult

Resultado da operação AreaOfInterest.

Nome Tipo Description
areaOfInterest

BoundingRect

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

metadata

ImageMetadata

Metadados de imagem.

modelVersion

string

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

Versão do modelo de IA.

requestId

string

ID da solicitação da API REST.

BoundingRect

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

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

O código de erro.

Valor Description
InternalServerError
InvalidArgument
InvalidRequest
ServiceUnavailable

ComputerVisionErrorResponse

A resposta de erro da API.

Nome Tipo Description
error

ComputerVisionError

Conteúdo de erro.

ComputerVisionInnerError

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

O código de erro.

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

ImageMetadata

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.