Face List Operations - Create Face List

Service:

Azure AI Services

API Version:

v1.1-preview.1

Create uma Lista de Rostos vazia com faceListId especificado pelo utilizador, nome, um userData opcional e recognitionModel.
São permitidos até 64 Listas Face numa subscrição.

A Lista de Rostos é uma lista de rostos, até 1000 rostos, e utilizada por "Localizar Semelhante na Lista de Rostos".

Após a criação, o utilizador deve utilizar "Adicionar Rosto da Lista de Rostos" para importar os rostos. Não será armazenada nenhuma imagem. Apenas as funcionalidades faciais extraídas serão armazenadas no servidor até que seja chamada "Eliminar Lista de Rostos".

"Localizar Semelhante" é utilizado para cenários como encontrar rostos semelhantes a celebridades, filtragem de rostos semelhantes ou como uma identificação facial leve. No entanto, se a utilização real for para identificar uma pessoa, utilize o Grupo de Pessoas/Grupo de Pessoas Grandes e "Identificar".

Considere a Lista de Rostos Grandes quando o número do rosto for grande. Pode suportar até 1000 000 rostos.

PUT {endpoint}/face/{apiVersion}/facelists/{faceListId}

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
apiVersion	path	True	string	Versão da API
endpoint	path	True	string uri	Pontos finais dos Serviços Cognitivos suportados (protocolo e nome do anfitrião, por exemplo: https://{resource-name}.cognitiveservices.azure.com).
faceListId	path	True	string	O caráter válido é letra em minúsculas ou dígitos ou "-" ou "_", o comprimento máximo é 64. Regex pattern: ^[a-z0-9-_]+$

Corpo do Pedido

Name	Necessário	Tipo	Description
name	True	string	Nome definido pelo utilizador: o comprimento máximo é 128.
recognitionModel		RecognitionModel	O "recognitionModel" associado a esta lista de rostos. Os valores "recognitionModel" suportados incluem "recognition_01", "recognition_02, "recognition_03" e "recognition_04". O valor predefinido é "recognition_01". Recomenda-se "recognition_04", uma vez que a sua precisão é melhorada nos rostos que usam máscaras em comparação com "recognition_03", e a sua precisão geral é melhorada em comparação com "recognition_01" e "recognition_02".
userData		string	Dados definidos pelo utilizador opcionais. O comprimento não deve exceder os 16 000.

Respostas

Name	Tipo	Description
200 OK		O pedido foi efetuada com êxito.
Other Status Codes	FaceErrorResponse	Uma resposta de erro inesperada. Headers x-ms-error-code: string

Segurança

Ocp-Apim-Subscription-Key

A chave secreta da sua subscrição do Azure AI Face.

Type: apiKey
In: header

AADToken

O Fluxo OAuth2 do Azure Active Directory

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

Name	Description
https://cognitiveservices.azure.com/.default

Exemplos

Create FaceList

Sample Request

HTTP

PUT {endpoint}/face/v1.1-preview.1/facelists/your_face_list_id

{
  "name": "your_face_list_name",
  "userData": "your_user_data",
  "recognitionModel": "recognition_01"
}

Sample Response

Status code:

200

Definições

Name	Description
FaceError	O objeto de erro. Para obter detalhes abrangentes sobre os códigos de erro e as mensagens devolvidas pelo Serviço Face, veja a seguinte ligação: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Uma resposta que contém detalhes de erro.

FaceError

O objeto de erro. Para obter detalhes abrangentes sobre os códigos de erro e as mensagens devolvidas pelo Serviço Face, veja a seguinte ligação: https://aka.ms/face-error-codes-and-messages.

Name	Tipo	Description
code	string	Um dos conjuntos de códigos de erro definidos pelo servidor.
message	string	Uma representação legível por humanos do erro.

FaceErrorResponse

Uma resposta que contém detalhes de erro.

Name	Tipo	Description
error	FaceError	O objeto de erro.