Image Analysis - Segment Image

Služba:

Azure AI Services

Verze rozhraní API:

2023-04-01-preview

Analyzujte vstupní obrázek. Požadavek buď obsahuje stream obrázku s libovolným typem obsahu ['image/*', 'application/octet-stream'], nebo datovou částí JSON, která obsahuje vlastnost url, která se má použít k načtení streamu obrázku. Vrátí se datový proud obsahu typu image/png, kde hodnoty pixelů závisí na režimu analýzy. Vrácený obrázek má stejné rozměry jako vstupní obrázek pro režimy: foregroundMatting. Vrácený obrázek má stejný poměr stran a stejné rozměry jako vstupní obrázek až do limitu 16 pixelů pro režimy: backgroundRemoval.

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

S volitelnými parametry:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
api-version	query	True	string	Požadovaná verze rozhraní API
mode	query		SegmentationMode	Požadovaný režim analýzy.

Text požadavku

Name	Vyžadováno	Typ	Description
url	True	string	Veřejně dostupná adresa URL obrázku

Odpovědi

Name	Typ	Description
200 OK	file	Úspěch Media Types: "image/png", "application/json"
Other Status Codes	ErrorResponse	Chyba Media Types: "image/png", "application/json" Hlavičky x-ms-error-code: string

Příklady

Segment_BackgroundRemoval_FromImageUrl

Segment_ForegroundMatting_FromImageUrl

Segment_BackgroundRemoval_FromImageUrl

Ukázkový požadavek

HTTP

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

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

Ukázková odpověď

Stavový kód:

200

"Ynl0ZXM="

Segment_ForegroundMatting_FromImageUrl

Ukázkový požadavek

HTTP

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

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

Ukázková odpověď

Stavový kód:

200

"Ynl0ZXM="

Definice

Name	Description
ErrorResponse	Odpověď se vrátí, když dojde k chybě.
ErrorResponseDetails	Informace o chybě
ErrorResponseInnerError	Podrobná chyba
ImageUrl	Dokument JSON s adresou URL odkazující na obrázek, který se má analyzovat.
SegmentationMode	Požadovaný režim analýzy.

ErrorResponse

Objekt

Odpověď se vrátí, když dojde k chybě.

Name	Typ	Description
error	ErrorResponseDetails	Informace o chybě

ErrorResponseDetails

Objekt

Informace o chybě

Name	Typ	Description
code	string	Kód chyby
details	ErrorResponseDetails[]	Seznam podrobných chyb
innererror	ErrorResponseInnerError	Podrobná chyba
message	string	Zpráva o chybě.
target	string	Cíl chyby.

ErrorResponseInnerError

Objekt

Podrobná chyba

Name	Typ	Description
code	string	Kód chyby
innererror	ErrorResponseInnerError	Podrobná chyba
message	string	Zpráva o chybě.

ImageUrl

Objekt

Dokument JSON s adresou URL odkazující na obrázek, který se má analyzovat.

Name	Typ	Description
url	string	Veřejně dostupná adresa URL obrázku

SegmentationMode

Výčet

Požadovaný režim analýzy.

Hodnota	Description
backgroundRemoval
foregroundMatting