Image Analysis - Segment Image
入力イメージを分析します。 要求には、任意のコンテンツ タイプ ['image/*'、'application/octet-stream']を持つ画像ストリーム、または画像ストリームの取得に使用する URL プロパティを含む JSON ペイロードが含まれます。 コンテンツ タイプ 'image/png' の画像ストリームが返され、ピクセル値は分析モードによって異なります。 返される画像は、foregroundMatting モードの入力画像と同じ寸法です。 返される画像は縦横比は同じで、入力画像と同じ寸法で、backgroundRemoval のモードでは最大 16 メガピクセルまでとなります。
POST /imageanalysis:segment?api-version=2023-04-01-preview
POST /imageanalysis:segment?mode={mode}&api-version=2023-04-01-preview
URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
api-version
|
query | True |
string |
要求された API バージョン。 |
|
mode
|
query |
要求された分析モード。 |
要求本文
| 名前 | 必須 | 型 | 説明 |
|---|---|---|---|
| url | True |
string |
イメージのパブリックに到達可能な URL。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
file |
成功 Media Types: "image/png", "application/json" |
| Other Status Codes |
エラー Media Types: "image/png", "application/json" ヘッダー x-ms-error-code: string |
例
|
Segment_Background |
|
Segment_Foreground |
Segment_BackgroundRemoval_FromImageUrl
要求のサンプル
POST /imageanalysis:segment?mode=backgroundRemoval&api-version=2023-04-01-preview
{
"url": "{image url}"
}
応答のサンプル
"Ynl0ZXM="
Segment_ForegroundMatting_FromImageUrl
要求のサンプル
POST /imageanalysis:segment?mode=foregroundMatting&api-version=2023-04-01-preview
{
"url": "{image url}"
}
応答のサンプル
"Ynl0ZXM="
定義
| 名前 | 説明 |
|---|---|
|
Error |
エラーが発生したときに返される応答。 |
|
Error |
エラー情報。 |
|
Error |
詳細なエラー。 |
|
Image |
分析する画像を指す URL を含む JSON ドキュメント。 |
|
Segmentation |
要求された分析モード。 |
ErrorResponse
エラーが発生したときに返される応答。
| 名前 | 型 | 説明 |
|---|---|---|
| error |
エラー情報。 |
ErrorResponseDetails
エラー情報。
| 名前 | 型 | 説明 |
|---|---|---|
| code |
string |
エラー コード。 |
| details |
詳細なエラーの一覧。 |
|
| innererror |
詳細なエラー。 |
|
| message |
string |
エラーメッセージ。 |
| target |
string |
エラーのターゲット。 |
ErrorResponseInnerError
詳細なエラー。
| 名前 | 型 | 説明 |
|---|---|---|
| code |
string |
エラー コード。 |
| innererror |
詳細なエラー。 |
|
| message |
string |
エラーメッセージ。 |
ImageUrl
分析する画像を指す URL を含む JSON ドキュメント。
| 名前 | 型 | 説明 |
|---|---|---|
| url |
string |
イメージのパブリックに到達可能な URL。 |
SegmentationMode
要求された分析モード。
| 値 | 説明 |
|---|---|
| backgroundRemoval | |
| foregroundMatting |