Image Analysis - Segment

Dienst:

Cognitive Services - Computer Vision

API-Version:

2023-02-01-preview

Analysieren Sie das Eingabebild. Die Anforderung enthält entweder einen Bilddatenstrom mit einem beliebigen Inhaltstyp ['image/*', 'application/octet-stream'] oder eine JSON-Nutzlast, die eine URL-Eigenschaft enthält, die zum Abrufen des Bilddatenstroms verwendet werden soll. Ein Bildstream vom Inhaltstyp "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 Abmessungen wie das Eingabebild bis zu einem Grenzwert von 16 Megapixeln für Modi: backgroundRemoval.

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

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
api-version	query	True	string	Angeforderte API-Version.
mode	query		SegmentationModeApiModel	Der angeforderte Analysemodus. Einer von: backgroundRemoval, foregroundMatting.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
url	True	string	Öffentlich erreichbare URL eines Bilds.

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_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="

Definitionen

Name	Beschreibung
ErrorResponse	Die Antwort wird zurückgegeben, wenn ein Fehler auftritt.
ErrorResponseDetails	Fehlerinformationen.
ErrorResponseInnerError	Detaillierter Fehler.
ImageUrl	Ein JSON-Dokument mit einer URL, die auf das zu analysierende Bild verweist.
SegmentationModeApiModel	Der angeforderte Analysemodus. Einer von: backgroundRemoval, foregroundMatting.

ErrorResponse

Die Antwort wird zurückgegeben, 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.

ImageUrl

Ein JSON-Dokument mit einer URL, die auf das zu analysierende Bild verweist.

Name	Typ	Beschreibung
url	string	Öffentlich erreichbare URL eines Bilds.

SegmentationModeApiModel

Der angeforderte Analysemodus. Einer von: backgroundRemoval, foregroundMatting.

Name	Typ	Beschreibung
backgroundRemoval	string
foregroundMatting	string