Image Analysis - Segment

Szolgáltatás:

Cognitive Services - Computer Vision

API-verzió:

2023-02-01-preview

A bemeneti kép elemzése. A kérelem tartalmaz egy képstreamet bármilyen tartalomtípussal :image/*", "application/octet-stream", vagy egy JSON hasznos adattal, amely tartalmaz egy URL-tulajdonságot a képstream lekéréséhez. A rendszer "image/png" tartalomtípusú képstreamet ad vissza, ahol a képpontértékek az elemzési módtól függenek. A visszaadott kép mérete megegyezik a módok bemeneti képének dimenzióival: előtérformátum. A visszaadott kép méretaránya és mérete megegyezik a bemeneti kép méretével 16 megapixeles korlátig a következő módok esetében: backgroundRemoval.

POST /imageanalysis:segment?api-version=2023-02-01-preview

Opcionális paraméterekkel:

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
api-version	query	True	string	Kért API-verzió.
mode	query		SegmentationModeApiModel	A kért elemzési mód. Az egyik: backgroundRemoval, foregroundMatting.

Kérelem törzse

Name	Kötelező	Típus	Description
url	True	string	Egy kép nyilvánosan elérhető URL-címe.

Válaszok

Name	Típus	Description
200 OK	file	Success Media Types: "image/png", "application/json"
Other Status Codes	ErrorResponse	Hiba Media Types: "image/png", "application/json" Fejlécek x-ms-error-code: string

Példák

Segment_BackgroundRemoval_FromImageUrl

Segment_ForegroundMatting_FromImageUrl

Segment_BackgroundRemoval_FromImageUrl

Sample request

HTTP

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

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

Sample response

Status code:

200

"Ynl0ZXM="

Segment_ForegroundMatting_FromImageUrl

Sample request

HTTP

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

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

Sample response

Status code:

200

"Ynl0ZXM="

Definíciók

Name	Description
ErrorResponse	Hiba esetén visszaadott válasz.
ErrorResponseDetails	Hibainformáció.
ErrorResponseInnerError	Részletes hiba.
ImageUrl	Egy JSON-dokumentum, amelynek URL-címe az elemezni kívánt képre mutat.
SegmentationModeApiModel	A kért elemzési mód. Az egyik: backgroundRemoval, foregroundMatting.

ErrorResponse

Hiba esetén visszaadott válasz.

Name	Típus	Description
error	ErrorResponseDetails	Hibainformáció.

ErrorResponseDetails

Hibainformáció.

Name	Típus	Description
code	string	Hibakód.
details	ErrorResponseDetails[]	Részletes hibák listája.
innererror	ErrorResponseInnerError	Részletes hiba.
message	string	Hibaüzenet.
target	string	A hiba célja.

ErrorResponseInnerError

Részletes hiba.

Name	Típus	Description
code	string	Hibakód.
innererror	ErrorResponseInnerError	Részletes hiba.
message	string	Hibaüzenet.

ImageUrl

Egy JSON-dokumentum, amelynek URL-címe az elemezni kívánt képre mutat.

Name	Típus	Description
url	string	Egy kép nyilvánosan elérhető URL-címe.

SegmentationModeApiModel

A kért elemzési mód. Az egyik: backgroundRemoval, foregroundMatting.

Name	Típus	Description
backgroundRemoval	string
foregroundMatting	string