Face List Operations - Create Large Face List

Service:

Azure AI Services

API Version:

v1.1-preview.1

Create uma Lista de Rostos Grandes vazia com largeFaceListId especificado pelo utilizador, nome, um userData opcional e recognitionModel.
A Lista De Rostos Grandes é uma lista de rostos, até 1000.000 rostos, e utilizada por "Localizar Semelhante a Partir da Lista de Rostos Grandes".

Após a criação, o utilizador deve utilizar Adicionar Rosto de Lista De Rostos Grandes para importar os rostos e Preparar a Lista de Rostos Grandes para o preparar para "Localizar Semelhante". Nenhuma imagem será armazenada. Apenas as funcionalidades faciais extraídas serão armazenadas no servidor até que a opção Eliminar Lista de Rostos Grandes seja chamada.

"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 Grupo de Pessoas/Grupo de Pessoas Grandes e "Identificar".

Nota

• • Quota de subscrição de escalão gratuito: 64 Listas Face Grande.
  • Quota de subscrição de escalão S0: 1000 000 Listas Face Grande.

PUT {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}

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).
largeFaceListId	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 K.

Respostas

Name	Tipo	Description
200 OK		O pedido foi bem-sucedido.
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

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 LargeFaceList

Sample Request

HTTP

PUT {endpoint}/face/v1.1-preview.1/largefacelists/your_large_face_list_id

{
  "name": "your_large_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, consulte 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, consulte 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.