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 |
A resposta inclui a área de interesse extraída no formato JSON. |
|
Other Status Codes |
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 |
---|---|
Area |
Resultado da operação AreaOfInterest. |
Bounding |
Uma caixa delimitadora para uma área dentro de uma imagem. |
Computer |
O erro de solicitação de API. |
Computer |
O código de erro. |
Computer |
A resposta de erro da API. |
Computer |
Detalhes sobre o erro de solicitação de API. |
Computer |
O código de erro. |
Image |
Metadados de imagem. |
AreaOfInterestResult
Resultado da operação AreaOfInterest.
Nome | Tipo | Description |
---|---|---|
areaOfInterest |
Uma caixa delimitadora para uma área de interesse dentro de uma imagem. |
|
metadata |
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 |
O código de erro. |
|
innererror |
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 |
Conteúdo de erro. |
ComputerVisionInnerError
Detalhes sobre o erro de solicitação de API.
Nome | Tipo | Description |
---|---|---|
code |
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. |