Image Moderation - Find Faces Url Input

Servicio:

Cognitive Services

Versión de la API:

1.0

Devuelve la lista de caras encontradas.

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

Con parámetros opcionales:

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
Endpoint	path	True	string	Puntos de conexión de Azure Cognitive Services admitidos (protocolo y nombre de host, como https://westus.api.cognitive.microsoft.com).
CacheImage	query		boolean	Si desea conservar la imagen enviada para su uso futuro. Si se omite, el valor predeterminado es false.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
Ocp-Apim-Subscription-Key	True	string
Content-Type	True	string	Tipo de contenido.

Cuerpo de la solicitud

Nombre	Tipo	Description
DataRepresentation	string
Value	string

Respuestas

Nombre	Tipo	Description
200 OK	FoundFaces	Lista de caras encontradas.
Other Status Codes	APIError	Respuesta de error.

Seguridad

Ocp-Apim-Subscription-Key

Tipo: apiKey
En: header

Ejemplos

Find Faces request

Solicitud de ejemplo

HTTP

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



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

Respuesta de muestra

status code:

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"
}

Definiciones

Nombre	Description
APIError	Información de error que devuelve la API.
Error	Cuerpo del error.
Face	Coordenadas de la cara encontrada.
FoundFaces	Objeto request que contiene caras encontradas.
KeyValuePair	Propiedades del objeto de par clave-valor.
Status	Propiedades de estado.

APIError

Información de error que devuelve la API.

Nombre	Tipo	Description
Error	Error	Cuerpo del error.

Error

Cuerpo del error.

Nombre	Tipo	Description
Code	string
Message	string

Face

Coordenadas de la cara encontrada.

Nombre	Tipo	Description
Bottom	integer	Coordenada inferior.
Left	integer	Coordenada izquierda.
Right	integer	Coordenada derecha.
Top	integer	Coordenada superior.

FoundFaces

Objeto request que contiene caras encontradas.

Nombre	Tipo	Description
AdvancedInfo	KeyValuePair[]	Información avanzada.
CacheId	string	Id. de caché.
Count	integer	Número de caras encontradas.
Faces	Face[]	Lista de caras.
Result	boolean	True si se encontró un resultado.
Status	Status	Estado de evaluación.
TrackingId	string	Id. de seguimiento.

KeyValuePair

Propiedades del objeto de par clave-valor.

Nombre	Tipo	Description
Key	string	Parámetro clave.
Value	string	Parámetro value.

Status

Propiedades de estado.

Nombre	Tipo	Description
Code	integer	Código de estado.
Description	string	Descripción del estado.
Exception	string	Estado de excepción.