Person Group Operations - Train Person Group
Übermitteln sie eine Personengruppe-Trainingsaufgabe. Das Training ist ein entscheidender Schritt, bei dem nur eine trainierte Personengruppe von "Aus Personengruppe identifizieren" verwendet werden kann.
Die Trainingsaufgabe ist eine asynchrone Aufgabe. Die Trainingszeit hängt von der Anzahl der Personeneinträge und ihren Gesichtern in einer Personengruppe ab. Dies kann mehrere Sekunden bis Minuten dauern. Um status zu überprüfen, verwenden Sie bitte "Personengruppentrainingsstatus abrufen".
POST {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/train
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
api
|
path | True |
string |
API-Version |
endpoint
|
path | True |
string uri |
Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. https://{resource-name}.cognitiveservices.azure.com). |
person
|
path | True |
string |
ID des Containers. Regex pattern: |
Antworten
Name | Typ | Beschreibung |
---|---|---|
202 Accepted |
Ein erfolgreicher Aufruf gibt einen leeren Antworttext zurück. Headers operation-Location: string |
|
Other Status Codes |
Eine unerwartete Fehlerantwort. Headers x-ms-error-code: string |
Sicherheit
Ocp-Apim-Subscription-Key
Der geheime Schlüssel für Ihr Azure AI Face-Abonnement.
Type:
apiKey
In:
header
AADToken
Der Azure Active Directory OAuth2-Flow
Type:
oauth2
Flow:
accessCode
Authorization URL:
https://api.example.com/oauth2/authorize
Token URL:
https://api.example.com/oauth2/token
Scopes
Name | Beschreibung |
---|---|
https://cognitiveservices.azure.com/.default |
Beispiele
Train PersonGroup
Sample Request
POST {endpoint}/face/v1.1-preview.1/persongroups/your_person_group_id/train
Sample Response
operation-Location: https://contoso.com/operationstatus
Definitionen
Name | Beschreibung |
---|---|
Face |
Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Nachrichten, die vom Gesichtserkennungsdienst zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages. |
Face |
Eine Antwort, die Fehlerdetails enthält. |
FaceError
Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Nachrichten, die vom Gesichtserkennungsdienst zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Einer der vom Server definierten Fehlercodes. |
message |
string |
Eine für Menschen lesbare Darstellung des Fehlers. |
FaceErrorResponse
Eine Antwort, die Fehlerdetails enthält.
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |