Image Moderation - Find Faces Url Input

Referência

Serviço:: Cognitive Services

Versão da API:: 1.0

Retorna a lista de rostos encontrados.

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

Com parâmetros opcionais:

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
Endpoint	path	True	string	Pontos de extremidade dos Serviços Cognitivos do Azure com suporte (nome do protocolo e do host, como https://westus.api.cognitive.microsoft.com).
CacheImage	query		boolean	Se deseja manter a imagem enviada para uso futuro. Se for omitido, o padrão será false.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
Ocp-Apim-Subscription-Key	True	string
Content-Type	True	string	Tipo de conteúdo.

Corpo da solicitação

Nome	Tipo	Description
DataRepresentation	string
Value	string

Respostas

Nome	Tipo	Description
200 OK	FoundFaces	Lista de rostos encontrados.
Other Status Codes	APIError	Resposta de erro.

Segurança

Ocp-Apim-Subscription-Key

Tipo: apiKey
Em: header

Exemplos

Find Faces request

Solicitação de exemplo

HTTP

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



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

Resposta de exemplo

Código de status:: 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"
}

Definições

Nome	Description
APIError	Informações de erro retornadas pela API.
Error	Corpo do erro.
Face	Coordenadas para o rosto encontrado.
FoundFaces	Objeto request que contém rostos encontrados.
KeyValuePair	Propriedades do objeto de par chave/valor.
Status	Propriedades de status.

APIError

Informações de erro retornadas pela API.

Nome	Tipo	Description
Error	Error	Corpo do erro.

Error

Corpo do erro.

Nome	Tipo	Description
Code	string
Message	string

Face

Coordenadas para o rosto encontrado.

Nome	Tipo	Description
Bottom	integer	Coordenada inferior.
Left	integer	Coordenada esquerda.
Right	integer	Coordenada direita.
Top	integer	Coordenada superior.

FoundFaces

Objeto request que contém rostos encontrados.

Nome	Tipo	Description
AdvancedInfo	KeyValuePair[]	Informações avançadas.
CacheId	string	ID do cache.
Count	integer	Número de rostos encontrados.
Faces	Face[]	Lista de rostos.
Result	boolean	True se um resultado foi encontrado.
Status	Status	Status de avaliação.
TrackingId	string	ID de rastreamento.

KeyValuePair

Propriedades do objeto de par chave/valor.

Nome	Tipo	Description
Key	string	Parâmetro de chave.
Value	string	Parâmetro value.

Status

Propriedades de status.

Nome	Tipo	Description
Code	integer	Código de status.
Description	string	Descrição do status.
Exception	string	Status de exceção.

Compartilhar via