Compartir a través de


Image Analysis - Segment

Analice la imagen de entrada. La solicitud contiene una secuencia de imagen con cualquier tipo de contenido ['image/*', 'application/octet-stream'] o una carga JSON que incluye una propiedad URL que se usará para recuperar la secuencia de imágenes. Se devuelve un flujo de imagen del tipo de contenido "image/png", donde los valores de píxel dependen del modo de análisis. La imagen devuelta tiene las mismas dimensiones que la imagen de entrada para los modos: foregroundMatting. La imagen devuelta tiene la misma relación de aspecto y las mismas dimensiones que la imagen de entrada hasta un límite de 16 megapíxeles para los modos: backgroundRemoval.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
api-version
query True

string

Versión de API solicitada.

mode
query

SegmentationModeApiModel

Modo de análisis solicitado. Uno de: backgroundRemoval, foregroundMatting.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
url True

string

Dirección URL accesible públicamente de una imagen.

Respuestas

Nombre Tipo Description
200 OK

file

Correcto

Media Types: "image/png", "application/json"

Other Status Codes

ErrorResponse

Error

Media Types: "image/png", "application/json"

Encabezados

x-ms-error-code: string

Ejemplos

Segment_BackgroundRemoval_FromImageUrl
Segment_ForegroundMatting_FromImageUrl

Segment_BackgroundRemoval_FromImageUrl

Solicitud de ejemplo

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

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

Respuesta de muestra

"Ynl0ZXM="

Segment_ForegroundMatting_FromImageUrl

Solicitud de ejemplo

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

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

Respuesta de muestra

"Ynl0ZXM="

Definiciones

Nombre Description
ErrorResponse

Respuesta devuelta cuando se produce un error.

ErrorResponseDetails

Información de error.

ErrorResponseInnerError

Error detallado.

ImageUrl

Un documento JSON con una dirección URL que apunta a la imagen que se va a analizar.

SegmentationModeApiModel

Modo de análisis solicitado. Uno de: backgroundRemoval, foregroundMatting.

ErrorResponse

Respuesta devuelta cuando se produce un error.

Nombre Tipo Description
error

ErrorResponseDetails

Información de error.

ErrorResponseDetails

Información de error.

Nombre Tipo Description
code

string

Código de error.

details

ErrorResponseDetails[]

Lista de errores detallados.

innererror

ErrorResponseInnerError

Error detallado.

message

string

Mensaje de error.

target

string

Destino del error.

ErrorResponseInnerError

Error detallado.

Nombre Tipo Description
code

string

Código de error.

innererror

ErrorResponseInnerError

Error detallado.

message

string

Mensaje de error.

ImageUrl

Un documento JSON con una dirección URL que apunta a la imagen que se va a analizar.

Nombre Tipo Description
url

string

Dirección URL accesible públicamente de una imagen.

SegmentationModeApiModel

Modo de análisis solicitado. Uno de: backgroundRemoval, foregroundMatting.

Nombre Tipo Description
backgroundRemoval

string

foregroundMatting

string