Image Analysis - Segment

Usługa:

Azure AI Services

Wersja interfejsu API:

2023-02-01-preview

Przeanalizuj obraz wejściowy. Żądanie zawiera strumień obrazu z dowolnym typem zawartości ["image/*", "application/octet-stream" lub ładunkiem JSON, który zawiera właściwość adresu URL do pobrania strumienia obrazu. Zwracany jest strumień obrazu typu zawartości "image/png", w którym wartości pikseli zależą od trybu analizy. Zwrócony obraz ma te same wymiary co obraz wejściowy dla trybów: foregroundMatting. Zwrócony obraz ma ten sam współczynnik proporcji i te same wymiary co obraz wejściowy do limitu 16 pikseli dla trybów: backgroundRemoval.

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

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
api-version	query	True	string	Żądana wersja interfejsu API.
mode	query		SegmentationModeApiModel	Żądany tryb analizy. Jeden z: backgroundRemoval, foregroundMatting.

Treść żądania

Nazwa	Wymagane	Typ	Opis
url	True	string	Publiczny adres URL obrazu.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	file	Powodzenie Media Types: "image/png", "application/json"
Other Status Codes	ErrorResponse	Błąd Media Types: "image/png", "application/json" Nagłówki x-ms-error-code: string

Przykłady

Segment_BackgroundRemoval_FromImageUrl

Segment_ForegroundMatting_FromImageUrl

Segment_BackgroundRemoval_FromImageUrl

Przykładowe żądanie

HTTP

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

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

Przykładowa odpowiedź

Kod stanu:

200

"Ynl0ZXM="

Segment_ForegroundMatting_FromImageUrl

Przykładowe żądanie

HTTP

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

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

Przykładowa odpowiedź

Kod stanu:

200

"Ynl0ZXM="

Definicje

Nazwa	Opis
ErrorResponse	Odpowiedź zwrócona po wystąpieniu błędu.
ErrorResponseDetails	Informacje o błędzie.
ErrorResponseInnerError	Szczegółowy błąd.
ImageUrl	Dokument JSON z adresem URL wskazującym obraz, który ma zostać przeanalizowany.
SegmentationModeApiModel	Żądany tryb analizy. Jeden z: backgroundRemoval, foregroundMatting.

ErrorResponse

Odpowiedź zwrócona po wystąpieniu błędu.

Nazwa	Typ	Opis
error	ErrorResponseDetails	Informacje o błędzie.

ErrorResponseDetails

Informacje o błędzie.

Nazwa	Typ	Opis
code	string	Kod błędu.
details	ErrorResponseDetails[]	Lista szczegółowych błędów.
innererror	ErrorResponseInnerError	Szczegółowy błąd.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponseInnerError

Szczegółowy błąd.

Nazwa	Typ	Opis
code	string	Kod błędu.
innererror	ErrorResponseInnerError	Szczegółowy błąd.
message	string	Komunikat o błędzie.

ImageUrl

Dokument JSON z adresem URL wskazującym obraz, który ma zostać przeanalizowany.

Nazwa	Typ	Opis
url	string	Publiczny adres URL obrazu.

SegmentationModeApiModel

Żądany tryb analizy. Jeden z: backgroundRemoval, foregroundMatting.

Nazwa	Typ	Opis
backgroundRemoval	string
foregroundMatting	string