Image Analysis - Segment Image
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-04-01-previewPOST /imageanalysis:segment?mode={mode}&api-version=2023-04-01-previewParâmetros de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
api-version
|
query | True |
string |
Versão da API solicitada. |
|
mode
|
query |
O modo de análise solicitado. |
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 |
Erro Media Types: "image/png", "application/json" Cabeçalhos x-ms-error-code: string |
Exemplos
|
Segment_Background |
|
Segment_Foreground |
Segment_BackgroundRemoval_FromImageUrl
Solicitação de exemplo
POST /imageanalysis:segment?mode=backgroundRemoval&api-version=2023-04-01-preview
{
"url": "{image url}"
}
Resposta de exemplo
"Ynl0ZXM="Segment_ForegroundMatting_FromImageUrl
Solicitação de exemplo
POST /imageanalysis:segment?mode=foregroundMatting&api-version=2023-04-01-preview
{
"url": "{image url}"
}
Resposta de exemplo
"Ynl0ZXM="Definições
| Nome | Description |
|---|---|
|
Error |
Resposta retornada quando ocorre um erro. |
|
Error |
Informações de erro. |
|
Error |
Erro detalhado. |
|
Image |
Um documento JSON com uma URL apontando para a imagem que deve ser analisada. |
|
Segmentation |
O modo de análise solicitado. |
ErrorResponse
Resposta retornada quando ocorre um erro.
| Nome | Tipo | Description |
|---|---|---|
| error |
Informações de erro. |
ErrorResponseDetails
Informações de erro.
| Nome | Tipo | Description |
|---|---|---|
| code |
string |
Código do erro. |
| details |
Lista de erros detalhados. |
|
| innererror |
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 |
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. |
SegmentationMode
O modo de análise solicitado.
| Nome | Tipo | Description |
|---|---|---|
| backgroundRemoval |
string |
|
| foregroundMatting |
string |