Image Analysis - Segment Stream

服務:

Azure AI Services

API 版本:

2023-04-01-preview

分析輸入影像。 要求包含任何內容類型為 ['image/*'、'application/octet-stream'] 的影像數據流，或包含用來擷取影像數據流的 URL 屬性的 JSON 承載。 傳回內容類型 'image/png' 的影像數據流，其中圖元值取決於分析模式。 傳回的影像與模式輸入影像的維度相同：foregroundMatting。 傳回的影像具有與輸入影像相同的外觀比例和相同維度，且模式的限制為 16 MB 像素：backgroundRemoval。

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

含選擇性參數:

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

URI 參數

名稱	位於	必要	類型	Description
api-version	query	True	string	要求的 API 版本。
mode	query		SegmentationMode	要求的分析模式。

要求本文

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

名稱	類型	Description
body	string	影像數據流。

回應

名稱	類型	Description
200 OK	file	成功 Media Types: "image/png", "application/json"
Other Status Codes	ErrorResponse	[錯誤] Media Types: "image/png", "application/json" 標題 x-ms-error-code: string

範例

Segment_BackgroundRemoval_FromImageStream

Segment_ForegroundMatting_FromImageStream

Segment_BackgroundRemoval_FromImageStream

範例要求

HTTP

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

"Ynl0ZXM="

範例回覆

狀態碼:

200

"Ynl0ZXM="

Segment_ForegroundMatting_FromImageStream

範例要求

HTTP

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

"Ynl0ZXM="

範例回覆

狀態碼:

200

"Ynl0ZXM="

定義

名稱	Description
ErrorResponse	發生錯誤時傳回的回應。
ErrorResponseDetails	錯誤資訊。
ErrorResponseInnerError	詳細的錯誤。
SegmentationMode	要求的分析模式。

ErrorResponse

發生錯誤時傳回的回應。

名稱	類型	Description
error	ErrorResponseDetails	錯誤資訊。

ErrorResponseDetails

錯誤資訊。

名稱	類型	Description
code	string	錯誤碼。
details	ErrorResponseDetails[]	詳細錯誤清單。
innererror	ErrorResponseInnerError	詳細的錯誤。
message	string	錯誤訊息。
target	string	錯誤的目標。

ErrorResponseInnerError

詳細的錯誤。

名稱	類型	Description
code	string	錯誤碼。
innererror	ErrorResponseInnerError	詳細的錯誤。
message	string	錯誤訊息。

SegmentationMode

要求的分析模式。

名稱	類型	Description
backgroundRemoval	string
foregroundMatting	string