Image Moderation - Find Faces File Input

Serviço:

Azure AI 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=stream&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 a imagem enviada deve ser mantida para uso futuro. Se for omitido, o padrão será false.

Cabeçalho da solicitação

Media Types: "image/gif", "image/jpeg", "image/png", "image/bmp", "image/tiff"

Nome	Obrigatório	Tipo	Description
Ocp-Apim-Subscription-Key	True	string

Corpo da solicitação

Media Types: "image/gif", "image/jpeg", "image/png", "image/bmp", "image/tiff"

Nome	Tipo	Description
ImageStream	object (file)	Arquivo de imagem.

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

Definições

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

APIError

Objeto

Informações de erro retornadas pela API.

Nome	Tipo	Description
Error	Error	Corpo do erro.

Error

Objeto

Corpo do erro.

Nome	Tipo	Description
Code	string
Message	string

Face

Objeto

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

Objeto de solicitação 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 da avaliação.
TrackingId	string	ID de acompanhamento.

KeyValuePair

Objeto

Propriedades do objeto de par chave/valor.

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

Status

Objeto

Propriedades de status.

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