Freigeben über

Image Analysis - Segment Image

  • Referenz
Dienst:
Azure AI Services
API-Version:
2023-04-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-04-01-preview
Mit optionalen Parametern: 
POST /imageanalysis:segment?mode={mode}&api-version=2023-04-01-preview

URI-Parameter

Name In Erforderlich Typ Beschreibung
api-version
 query True

string

Angeforderte API-Version.
mode
 query

SegmentationMode

Der angeforderte Analysemodus.

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

Beispielanforderung

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

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

Beispiel für eine Antwort

Statuscode:
200 
"Ynl0ZXM="

Segment_ForegroundMatting_FromImageUrl

Beispielanforderung

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

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

Beispiel für eine Antwort

Statuscode:
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.
SegmentationMode

Der angeforderte Analysemodus.

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.

SegmentationMode

Der angeforderte Analysemodus.

Name Typ Beschreibung
backgroundRemoval

string

foregroundMatting

string