Face List Operations - Create Face List
Maak een lege face-lijst met door de gebruiker opgegeven faceListId, naam, een optionele userData en recognitionModel.
Maximaal 64 gezichtslijsten zijn toegestaan in één abonnement.
Gezichtslijst is een lijst met gezichten, maximaal 1000 gezichten en wordt gebruikt door 'Vergelijkbare gezichten zoeken uit gezichtslijst'.
Nadat de gebruiker is gemaakt, moet de gebruiker Face-lijst toevoegen gebruiken om de gezichten te importeren. Er wordt geen installatiekopieën opgeslagen. Alleen de geëxtraheerde gezichtsfuncties worden opgeslagen op de server totdat '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".
Houd rekening met grote gezichtslijst wanneer het gezichtsnummer groot is. Het kan maximaal 1.000.000 gezichten ondersteunen.
PUT {endpoint}/face/{apiVersion}/facelists/{faceListId}
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
api
|
path | True |
string |
API-versie |
endpoint
|
path | True |
string uri |
Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://{resource-name}.cognitiveservices.azure.com). |
face
|
path | True |
string |
Geldig teken is een letter in kleine letters of cijfers of '-' of '_', de maximumlengte is 64. Regex-patroon: |
Aanvraagbody
Name | Vereist | Type | Description |
---|---|---|---|
name | True |
string |
Door de gebruiker gedefinieerde naam, de maximale lengte is 128. |
recognitionModel |
Recognition |
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 |
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 FaceList
Voorbeeldaanvraag
PUT {endpoint}/face/v1.2-preview.1/facelists/your_face_list_id
{
"name": "your_face_list_name",
"userData": "your_user_data",
"recognitionModel": "recognition_01"
}
Voorbeeldrespons
Definities
Name | Description |
---|---|
Face |
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. |
Face |
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 |
Het foutobject. |