Image Analysis - Segment Image

Usługa:

Azure AI Services

Wersja interfejsu API:

2023-04-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-04-01-preview

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
api-version	query	True	string	Żądana wersja interfejsu API.
mode	query		SegmentationMode	Żądany tryb analizy.

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-04-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-04-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.
SegmentationMode	Żądany tryb analizy.

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.

SegmentationMode

Żądany tryb analizy.

Nazwa	Typ	Opis
backgroundRemoval	string
foregroundMatting	string