Image Analysis - Segment

Service:

Cognitive Services - Computer Vision

API Version:

2023-02-01-preview

Analise a imagem de entrada. A solicitação contém um fluxo de imagem com qualquer tipo de conteúdo ['image/*', 'application/octet-stream'], ou um conteúdo JSON que inclui uma propriedade de URL a ser usada para recuperar o fluxo de imagem. Um fluxo de imagem do tipo de conteúdo 'image/png' é retornado, em que os valores de pixel dependem do modo de análise. A imagem retornada tem as mesmas dimensões que a imagem de entrada para modos: foregroundMatting. A imagem retornada tem a mesma taxa de proporção e as mesmas dimensões que a imagem de entrada até um limite de 16 megapixels para modos: backgroundRemoval.

POST /imageanalysis:segment?api-version=2023-02-01-preview

With optional parameters:

POST /imageanalysis:segment?mode={mode}&api-version=2023-02-01-preview

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
api-version	query	True	string	Versão da API solicitada.
mode	query		SegmentationModeApiModel	O modo de análise solicitado. Um de: backgroundRemoval, foregroundMatting.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
url	True	string	URL acessível publicamente de uma imagem.

Respostas

Nome	Tipo	Description
200 OK	file	Êxito Media Types: "image/png", "application/json"
Other Status Codes	ErrorResponse	Erro Media Types: "image/png", "application/json" Headers x-ms-error-code: string

Exemplos

Segment_BackgroundRemoval_FromImageUrl

Segment_ForegroundMatting_FromImageUrl

Segment_BackgroundRemoval_FromImageUrl

Sample Request

HTTP

POST /imageanalysis:segment?mode=backgroundRemoval&api-version=2023-02-01-preview

{
  "url": "{image url}"
}

Sample Response

Status code:

200

"Ynl0ZXM="

Segment_ForegroundMatting_FromImageUrl

Sample Request

HTTP

POST /imageanalysis:segment?mode=foregroundMatting&api-version=2023-02-01-preview

{
  "url": "{image url}"
}

Sample Response

Status code:

200

"Ynl0ZXM="

Definições

Nome	Description
ErrorResponse	Resposta retornada quando ocorre um erro.
ErrorResponseDetails	Informações de erro.
ErrorResponseInnerError	Erro detalhado.
ImageUrl	Um documento JSON com uma URL apontando para a imagem que deve ser analisada.
SegmentationModeApiModel	O modo de análise solicitado. Um de: backgroundRemoval, foregroundMatting.

ErrorResponse

Resposta retornada quando ocorre um erro.

Nome	Tipo	Description
error	ErrorResponseDetails	Informações de erro.

ErrorResponseDetails

Informações de erro.

Nome	Tipo	Description
code	string	Código do erro.
details	ErrorResponseDetails[]	Lista de erros detalhados.
innererror	ErrorResponseInnerError	Erro detalhado.
message	string	Mensagem de erro.
target	string	Destino do erro.

ErrorResponseInnerError

Erro detalhado.

Nome	Tipo	Description
code	string	Código do erro.
innererror	ErrorResponseInnerError	Erro detalhado.
message	string	Mensagem de erro.

ImageUrl

Um documento JSON com uma URL apontando para a imagem que deve ser analisada.

Nome	Tipo	Description
url	string	URL acessível publicamente de uma imagem.

SegmentationModeApiModel

O modo de análise solicitado. Um de: backgroundRemoval, foregroundMatting.

Nome	Tipo	Description
backgroundRemoval	string
foregroundMatting	string