Share via

Image Analysis - Segment Stream

  • Reference
Service:
Azure AI Services
API Version:
2023-04-01-preview

Analyze the input image. The request either contains an image stream with any content type ['image/*', 'application/octet-stream'], or a JSON payload which includes a url property to be used to retrieve the image stream. An image stream of content type 'image/png' is returned, where the pixel values depend on the analysis mode. The returned image has the same dimensions as the input image for modes: foregroundMatting. The returned image has the same aspect ratio and same dimensions as the input image up to a limit of 16 megapixels for modes: backgroundRemoval.

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

URI Parameters

Name In Required Type Description
api-version
 query True

string

Requested API version.
mode
 query

SegmentationMode

The analysis mode requested.

Request Body

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

Name Type Description
body

string

An image stream.

Responses

Name Type Description
200 OK

file

Success

Media Types: "image/png", "application/json"
Other Status Codes

ErrorResponse

Error

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

Headers

x-ms-error-code: string

Examples

Segment_BackgroundRemoval_FromImageStream
Segment_ForegroundMatting_FromImageStream

Segment_BackgroundRemoval_FromImageStream

Sample request

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

"Ynl0ZXM="

Sample response

Status code:
200 
"Ynl0ZXM="

Segment_ForegroundMatting_FromImageStream

Sample request

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

"Ynl0ZXM="

Sample response

Status code:
200 
"Ynl0ZXM="

Definitions

Name Description
ErrorResponse

Response returned when an error occurs.
ErrorResponseDetails

Error info.
ErrorResponseInnerError

Detailed error.
SegmentationMode

The analysis mode requested.

ErrorResponse

Response returned when an error occurs.

Name Type Description
error

ErrorResponseDetails

Error info.

ErrorResponseDetails

Error info.

Name Type Description
code

string

Error code.
details

ErrorResponseDetails[]

List of detailed errors.
innererror

ErrorResponseInnerError

Detailed error.
message

string

Error message.
target

string

Target of the error.

ErrorResponseInnerError

Detailed error.

Name Type Description
code

string

Error code.
innererror

ErrorResponseInnerError

Detailed error.
message

string

Error message.

SegmentationMode

The analysis mode requested.

Name Type Description
backgroundRemoval

string

foregroundMatting

string