Liveness Session Operations - Get Session Image

Dienst:

Azure AI Services

API-Version:

v1.2-preview.1

Abrufen des Sitzungsbilds, das während der Liveness-Sitzung gespeichert ist.

GET {endpoint}/face/{apiVersion}/session/sessionImages/{sessionImageId}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
apiVersion	path	True	string	API-Version
endpoint	path	True	string uri	Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. https://{resource-name}.cognitiveservices.azure.com).
sessionImageId	path	True	string	Die Anforderungs-ID des abzurufenden Bilds

Antworten

Name	Typ	Beschreibung
200 OK	file	Die Anforderung ist erfolgreich. Media Types: "application/octet-stream", "application/json"
Other Status Codes	FaceErrorResponse	Unerwartete Fehlerantwort. Media Types: "application/octet-stream", "application/json" Header x-ms-error-code: string

Sicherheit

Ocp-Apim-Subscription-Key

Der geheime Schlüssel für Ihr Azure AI Face-Abonnement.

Typ: apiKey
In: header

AADToken

Der Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: accessCode
Autorisierungs-URL: https://api.example.com/oauth2/authorize
Token-URL: https://api.example.com/oauth2/token

Bereiche

Name	Beschreibung
https://cognitiveservices.azure.com/.default

Beispiele

Get Session Image

Beispielanforderung

HTTP

GET {endpoint}/face/v1.2-preview.1/session/sessionImages/3d035d35-2e01-4ed4-8935-577afde9caaa

Beispiel für eine Antwort

Statuscode:

200

"<session-image-bytes>"

Definitionen

Name	Beschreibung
FaceError	Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Nachrichten, die vom Face Service zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Eine Antwort, die Fehlerdetails enthält.

FaceError

Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Nachrichten, die vom Face Service zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
message	string	Eine lesbare Darstellung des Fehlers.

FaceErrorResponse

Eine Antwort, die Fehlerdetails enthält.

Name	Typ	Beschreibung
error	FaceError	Das Fehlerobjekt.