Image Analysis - Segment

Servicio:

Azure AI Services

Versión de la API:

2023-02-01-preview

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

Con parámetros opcionales:

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

HTTP

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

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

Respuesta de muestra

status code:

200

"Ynl0ZXM="

Segment_ForegroundMatting_FromImageUrl

Solicitud de ejemplo

HTTP

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

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

Respuesta de muestra

status code:

200

"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