共用方式為

Image Analysis - Segment Image

  • 參考
服務:
Azure AI Services
API 版本:
2023-04-01-preview

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

POST /imageanalysis:segment?api-version=2023-04-01-preview
含選擇性參數: 
POST /imageanalysis:segment?mode={mode}&api-version=2023-04-01-preview

URI 參數

名稱 位於 必要 類型 Description
api-version
 query True

string

要求的 API 版本。
mode
 query

SegmentationMode

所要求的分析模式。

要求本文

名稱 必要 類型 Description
url True

string

影像的可公開連線 URL。

回應

名稱 類型 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_FromImageUrl
Segment_ForegroundMatting_FromImageUrl

Segment_BackgroundRemoval_FromImageUrl

範例要求

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

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

範例回覆

狀態碼:
200 
"Ynl0ZXM="

Segment_ForegroundMatting_FromImageUrl

範例要求

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

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

範例回覆

狀態碼:
200 
"Ynl0ZXM="

定義

名稱 Description
ErrorResponse

發生錯誤時傳回的回應。
ErrorResponseDetails

錯誤資訊。
ErrorResponseInnerError

詳細的錯誤。
ImageUrl

JSON 檔，其中包含指向要分析之影像的 URL。
SegmentationMode

所要求的分析模式。

ErrorResponse

Object

發生錯誤時傳回的回應。

名稱 類型 Description
error

ErrorResponseDetails

錯誤資訊。

ErrorResponseDetails

Object

錯誤資訊。

名稱 類型 Description
code

string

錯誤碼。
details

ErrorResponseDetails[]

詳細的錯誤清單。
innererror

ErrorResponseInnerError

詳細的錯誤。
message

string

錯誤資訊。
target

string

錯誤的目標。

ErrorResponseInnerError

Object

詳細的錯誤。

名稱 類型 Description
code

string

錯誤碼。
innererror

ErrorResponseInnerError

詳細的錯誤。
message

string

錯誤資訊。

ImageUrl

Object

JSON 檔，其中包含指向要分析之影像的 URL。

名稱 類型 Description
url

string

影像的可公開連線 URL。

SegmentationMode

列舉型別

所要求的分析模式。

值 Description
backgroundRemoval
foregroundMatting