Face List Operations - Create Large Face List

Service:

Azure AI Services

API-versie:

v1.2-preview.1

Maak een lege Large Face List met door de gebruiker opgegeven largeFaceListId, name, een optionele userData en recognitionModel.
Grote gezichtslijst is een lijst met gezichten, maximaal 1.000.000 gezichten en wordt gebruikt door "Zoeken vergelijkbaar met grote gezichtslijst".

Nadat de gebruiker is gemaakt, moet de gebruiker Het gezicht met grote gezichten toevoegen gebruiken om de gezichten te importeren en grote gezichten te trainen om deze gereed te maken voor 'Zoeken vergelijkbaar'. Er wordt geen installatiekopieën opgeslagen. Alleen de geëxtraheerde gezichtsfuncties worden opgeslagen op de server totdat Grote gezichtslijst verwijderen wordt aangeroepen.

"Zoeken vergelijkbaar" wordt gebruikt voor scenario's zoals het vinden van beroemdhedenachtige gezichten, vergelijkbare gezichtsfilters of als een lichte gezichtsidentificatie. Maar als het werkelijke gebruik is om persoon te identificeren, gebruikt u Persoonsgroep / Grote Persoonsgroep en "Identificeren".

Notitie

• • Gratis abonnementsquotum: 64 Grote gezichtslijsten.
  • Quotum voor S0-lagen: 1.000.000 Grote gezichtslijsten.

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

URI-parameters

Name	In	Vereist	Type	Description
apiVersion	path	True	string	API-versie
endpoint	path	True	string uri	Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://{resource-name}.cognitiveservices.azure.com).
largeFaceListId	path	True	string	Geldig teken is een letter in kleine letters of cijfers of '-' of '_', de maximumlengte is 64. Regex-patroon: ^[a-z0-9-_]+$

Aanvraagbody

Name	Vereist	Type	Description
name	True	string	Door de gebruiker gedefinieerde naam, de maximale lengte is 128.
recognitionModel		RecognitionModel	Het 'recognitionModel' dat aan deze gezichtslijst is gekoppeld. Ondersteunde 'recognitionModel'-waarden zijn onder andere 'recognition_01', 'recognition_02, 'recognition_03' en 'recognition_04'. De standaardwaarde is 'recognition_01'. 'recognition_04' wordt aanbevolen omdat de nauwkeurigheid ervan wordt verbeterd op gezichten die maskers dragen in vergelijking met 'recognition_03', en de algehele nauwkeurigheid ervan wordt verbeterd in vergelijking met 'recognition_01' en 'recognition_02'.
userData		string	Optionele door de gebruiker gedefinieerde gegevens. De lengte mag niet groter zijn dan 16.000.

Antwoorden

Name	Type	Description
200 OK		De aanvraag is voltooid.
Other Status Codes	FaceErrorResponse	Een onverwachte foutreactie. Kopteksten x-ms-error-code: string

Beveiliging

Ocp-Apim-Subscription-Key

De geheime sleutel voor uw Azure AI Face-abonnement.

Type: apiKey
In: header

AADToken

De Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: accessCode
Autorisatie-URL: https://api.example.com/oauth2/authorize
Token-URL: https://api.example.com/oauth2/token

Bereiken

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

Voorbeelden

Create LargeFaceList

Voorbeeldaanvraag

HTTP

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

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

Voorbeeldrespons

Statuscode:

200

Definities

Name	Description
FaceError	Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Een antwoord met foutdetails.

FaceError

Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
message	string	Een leesbare weergave van de fout.

FaceErrorResponse

Een antwoord met foutdetails.

Name	Type	Description
error	FaceError	Het foutobject.