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 |
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 |
Error Media Types: "image/png", "application/json" Encabezados x-ms-error-code: string |
Ejemplos
Segment_Background |
Segment_Foreground |
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 |
---|---|
Error |
Respuesta devuelta cuando se produce un error. |
Error |
Información de error. |
Error |
Error detallado. |
Image |
Un documento JSON con una dirección URL que apunta a la imagen que se va a analizar. |
Segmentation |
Modo de análisis solicitado. Uno de: backgroundRemoval, foregroundMatting. |
ErrorResponse
Respuesta devuelta cuando se produce un error.
Nombre | Tipo | Description |
---|---|---|
error |
Información de error. |
ErrorResponseDetails
Información de error.
Nombre | Tipo | Description |
---|---|---|
code |
string |
Código de error. |
details |
Lista de errores detallados. |
|
innererror |
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 |
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 |