Image Analysis - Segment Stream

Dienst:

Azure AI Services

API-Version:

2023-04-01-preview

Analysieren Sie das Eingabebild. Die Anforderung enthält entweder einen Imagestream mit einem beliebigen Inhaltstyp ['image/*', 'application/octet-stream'], oder eine JSON-Nutzlast, die eine URL-Eigenschaft enthält, die zum Abrufen des Bildstreams verwendet werden soll. Ein Bildstream des Inhaltstyps "image/png" wird zurückgegeben, wobei die Pixelwerte vom Analysemodus abhängen. Das zurückgegebene Bild hat die gleichen Dimensionen wie das Eingabebild für Modi: foregroundMatting. Das zurückgegebene Bild hat das gleiche Seitenverhältnis und dieselben Dimensionen wie das Eingabebild bis zu einem Grenzwert von 16 Megapixeln für Modi: backgroundRemoval.

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

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
api-version	query	True	string	Api-Version angefordert.
mode	query		SegmentationMode	Der angeforderte Analysemodus.

Anforderungstext

Media Types: "application/octet-stream", "image/jpeg", "image/gif", "image/tiff", "image/bmp", "image/png"

Name	Typ	Beschreibung
body	string	Ein Bildstream.

Antworten

Name	Typ	Beschreibung
200 OK	file	Erfolg Media Types: "image/png", "application/json"
Other Status Codes	ErrorResponse	Fehler Media Types: "image/png", "application/json" Header x-ms-error-code: string

Beispiele

Segment_BackgroundRemoval_FromImageStream

Segment_ForegroundMatting_FromImageStream

Segment_BackgroundRemoval_FromImageStream

Beispielanforderung

HTTP

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

"Ynl0ZXM="

Beispiel für eine Antwort

Statuscode:

200

"Ynl0ZXM="

Segment_ForegroundMatting_FromImageStream

Beispielanforderung

HTTP

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

"Ynl0ZXM="

Beispiel für eine Antwort

Statuscode:

200

"Ynl0ZXM="

Definitionen

Name	Beschreibung
ErrorResponse	Antwort, die zurückgegeben wird, wenn ein Fehler auftritt.
ErrorResponseDetails	Fehlerinformationen.
ErrorResponseInnerError	Detaillierter Fehler.
SegmentationMode	Der angeforderte Analysemodus.

ErrorResponse

Antwort, die zurückgegeben wird, wenn ein Fehler auftritt.

Name	Typ	Beschreibung
error	ErrorResponseDetails	Fehlerinformationen.

ErrorResponseDetails

Fehlerinformationen.

Name	Typ	Beschreibung
code	string	Fehlercode
details	ErrorResponseDetails[]	Liste der detaillierten Fehler.
innererror	ErrorResponseInnerError	Detaillierter Fehler.
message	string	Fehlermeldung.
target	string	Ziel des Fehlers.

ErrorResponseInnerError

Detaillierter Fehler.

Name	Typ	Beschreibung
code	string	Fehlercode
innererror	ErrorResponseInnerError	Detaillierter Fehler.
message	string	Fehlermeldung.

SegmentationMode

Der angeforderte Analysemodus.

Name	Typ	Beschreibung
backgroundRemoval	string
foregroundMatting	string