Image Moderation - Find Faces Url Input

Référence

Service:: Cognitive Services

Version d'API:: 1.0

Retourne la liste des visages trouvés.

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

Avec des paramètres facultatifs:

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
Endpoint	path	True	string	Points de terminaison Azure Cognitive Services pris en charge (protocole et nom d’hôte, comme https://westus.api.cognitive.microsoft.com).
CacheImage	query		boolean	Indique s’il faut conserver l’image envoyée pour une utilisation ultérieure. S’il est omis, la valeur par défaut est false.

En-tête de la demande

Nom	Obligatoire	Type	Description
Ocp-Apim-Subscription-Key	True	string
Content-Type	True	string	Type de contenu.

Corps de la demande

Nom	Type	Description
DataRepresentation	string
Value	string

Réponses

Nom	Type	Description
200 OK	FoundFaces	Liste des visages trouvés.
Other Status Codes	APIError	Réponse d’erreur.

Sécurité

Ocp-Apim-Subscription-Key

Type: apiKey
Dans: header

Exemples

Find Faces request

Exemple de requête

HTTP

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



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

Exemple de réponse

Code d’état:: 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"
}

Définitions

Nom	Description
APIError	Informations d’erreur retournées par l’API.
Error	Corps de l’erreur.
Face	Coordonnées du visage trouvé.
FoundFaces	Objet request qui contient des visages trouvés.
KeyValuePair	Propriétés de l’objet de paire clé/valeur.
Status	Propriétés d’état.

APIError

Informations d’erreur retournées par l’API.

Nom	Type	Description
Error	Error	Corps de l’erreur.

Error

Corps de l’erreur.

Nom	Type	Description
Code	string
Message	string

Face

Coordonnées du visage trouvé.

Nom	Type	Description
Bottom	integer	Coordonnée inférieure.
Left	integer	Coordonnée de gauche.
Right	integer	Coordonnée droite.
Top	integer	Coordonnée supérieure.

FoundFaces

Objet request qui contient des visages trouvés.

Nom	Type	Description
AdvancedInfo	KeyValuePair[]	Informations avancées.
CacheId	string	ID de cache.
Count	integer	Nombre de visages trouvés.
Faces	Face[]	Liste de visages.
Result	boolean	True si un résultat a été trouvé.
Status	Status	Status d’évaluation.
TrackingId	string	ID de suivi.

KeyValuePair

Propriétés de l’objet de paire clé/valeur.

Nom	Type	Description
Key	string	Paramètre de clé.
Value	string	Paramètre de valeur.

Status

Propriétés d’état.

Nom	Type	Description
Code	integer	Code d’état.
Description	string	Description de l’état.
Exception	string	Exception status.

Partager via