Delen via


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

faceListId
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 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
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.