Image Analysis - Segment Stream

Serviço:

Azure AI Services

Versão da API:

2023-04-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 uma carga JSON que inclui uma propriedade 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 da imagem de entrada até um limite de 16 megapixels para os modos: backgroundRemoval.

POST /imageanalysis:segment?overload=stream&api-version=2023-04-01-preview

Com parâmetros opcionais:

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

Parâmetros de URI

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

Corpo da solicitação

Media Types: "application/octet-stream", "image/jpeg", "image/gif", "image/tiff", "image/bmp", "image/png"

Nome	Tipo	Description
body	string (byte)	Um fluxo de 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" Cabeçalhos x-ms-error-code: string

Exemplos

Segment_BackgroundRemoval_FromImageStream

Segment_ForegroundMatting_FromImageStream

Segment_BackgroundRemoval_FromImageStream

Solicitação de exemplo

HTTP

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

"Ynl0ZXM="

Resposta de exemplo

Código de status:

200

"Ynl0ZXM="

Segment_ForegroundMatting_FromImageStream

Solicitação de exemplo

HTTP

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

"Ynl0ZXM="

Resposta de exemplo

Código de status:

200

"Ynl0ZXM="

Definições

Nome	Description
ErrorResponse	Resposta retornada quando ocorre um erro.
ErrorResponseDetails	Informações de erro.
ErrorResponseInnerError	Erro detalhado.
SegmentationMode	O modo de análise solicitado.

ErrorResponse

Objeto

Resposta retornada quando ocorre um erro.

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

ErrorResponseDetails

Objeto

Informações de erro.

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

ErrorResponseInnerError

Objeto

Erro detalhado.

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

SegmentationMode

Enumeração

O modo de análise solicitado.

Valor	Description
backgroundRemoval
foregroundMatting