Image Moderation - Find Faces Url Input

Referenz

Dienst:: Cognitive Services

API-Version:: 1.0

Gibt die Liste der gefundenen Gesichter zurück.

POST {Endpoint}/contentmoderator/moderate/v1.0/ProcessImage/FindFaces

Mit optionalen Parametern:

POST {Endpoint}/contentmoderator/moderate/v1.0/ProcessImage/FindFaces?overload=url&CacheImage={CacheImage}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
Endpoint	path	True	string	Unterstützte Azure Cognitive Services-Endpunkte (Protokoll und Hostname, z. B https://westus.api.cognitive.microsoft.com. ).
CacheImage	query		boolean	Gibt an, ob das übermittelte Image für die zukünftige Verwendung beibehalten werden soll. Wenn es nicht angegeben wird, ist der Standardwert false.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
Ocp-Apim-Subscription-Key	True	string
Content-Type	True	string	Inhaltstyp.

Anforderungstext

Name	Typ	Beschreibung
DataRepresentation	string
Value	string

Antworten

Name	Typ	Beschreibung
200 OK	FoundFaces	Liste der gefundenen Gesichter.
Other Status Codes	APIError	Fehlerantwort.

Sicherheit

Ocp-Apim-Subscription-Key

Typ: apiKey
In: header

Beispiele

Find Faces request

Beispielanforderung

HTTP

POST {Endpoint}/contentmoderator/moderate/v1.0/ProcessImage/FindFaces?overload=url



{
  "DataRepresentation": "URL",
  "Value": "https://moderatorsampleimages.blob.core.windows.net/samples/img_300.jpg"
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "Faces": [
    {
      "Left": 80,
      "Right": 118,
      "Top": 44,
      "Bottom": 82
    }
  ],
  "Count": 1,
  "AdvancedInfo": [],
  "Result": true,
  "Status": {
    "Code": 3000,
    "Description": "OK",
    "Exception": ""
  },
  "TrackingId": "SEA_ad975eeae1f24f81bebb40be0c3ba4fd_ContentModerator.Preview_01158625-4fea-4dd5-8f21-5e2657ea2eee"
}

Definitionen

Name	Beschreibung
APIError	Fehlerinformationen, die die API zurückgibt.
Error	Fehlertext.
Face	Koordinaten zum gefundenen Gesicht.
FoundFaces	Anforderungsobjekt, das gefundene Gesichter enthält.
KeyValuePair	Eigenschaften von Schlüssel-Wert-Paarobjekten.
Status	Statuseigenschaften.

APIError

Fehlerinformationen, die die API zurückgibt.

Name	Typ	Beschreibung
Error	Error	Fehlertext.

Error

Fehlertext.

Name	Typ	Beschreibung
Code	string
Message	string

Face

Koordinaten zum gefundenen Gesicht.

Name	Typ	Beschreibung
Bottom	integer	Unterkoordinate.
Left	integer	Linke Koordinate.
Right	integer	Richtige Koordinate.
Top	integer	Obere Koordinate.

FoundFaces

Anforderungsobjekt, das gefundene Gesichter enthält.

Name	Typ	Beschreibung
AdvancedInfo	KeyValuePair[]	Erweiterte Informationen.
CacheId	string	Cache-ID.
Count	integer	Anzahl der gefundenen Gesichter.
Faces	Face[]	Liste der Gesichter.
Result	boolean	True, wenn ein Ergebnis gefunden wurde.
Status	Status	Auswertung status.
TrackingId	string	Nachverfolgungs-ID.

KeyValuePair

Eigenschaften von Schlüssel-Wert-Paarobjekten.

Name	Typ	Beschreibung
Key	string	Schlüsselparameter.
Value	string	Wertparameter.

Status

Statuseigenschaften.

Name	Typ	Beschreibung
Code	integer	Statuscode.
Description	string	Statusbeschreibung.
Exception	string	Ausnahme status.

Freigeben über