Face List Operations - Add Large Face List Face
Fügen Sie einer angegebenen großen Gesichtsliste ein Gesicht mit bis zu 1.000.000 Gesichtern hinzu.
Um ein Bild zu behandeln, das mehrere Gesichter enthält, kann die Eingabefläche als Bild mit einem targetFace-Rechteck angegeben werden. Es gibt eine persistedFaceId zurück, die das hinzugefügte Gesicht darstellt. Es wird kein Bild gespeichert. Nur die extrahierten Gesichtserkennungsfeatures werden auf dem Server gespeichert, bis "Große Gesichtsliste löschen" oder "Große Gesichtsliste löschen" aufgerufen wird.
Beachten Sie, dass sich persistedFaceId von faceId unterscheidet, die von "Detect" generiert wird.
-
- Höhere Gesichtsbildqualität bedeutet eine höhere Erkennungsgenauigkeit. Bitte berücksichtigen Sie hochwertige Gesichter: Die Front-, Klar- und Gesichtsgröße beträgt 200 x 200 Pixel (100 Pixel zwischen den Augen) oder größer.
- Jeder Personeneintrag kann bis zu 248 Gesichter enthalten.
- JPEG, PNG, GIF (der erste Frame) und BMP-Format werden unterstützt. Die zulässige Bilddateigröße liegt zwischen 1 KB und 6 MB.
- Das Rechteck "targetFace" sollte ein Gesicht enthalten. Null oder mehrere Gesichter werden als Fehler betrachtet. Wenn das angegebene "targetFace"-Rechteck nicht von "Detect" zurückgegeben wird, gibt es keine Garantie, dass das Gesicht erfolgreich erkannt und hinzugefügt wird.
- Aus der erkennbaren Gesichtsgröße (36x36 – 4096 x 4096 Pixel), große Kopfpose oder große Verschlüsse führen zu Fehlern.
- Die minimale erkennbare Gesichtsgröße beträgt 36 x 36 Pixel in einem Bild, das nicht größer als 1920 x 1080 Pixel ist. Bilder mit einer Größe von mehr als 1920 x 1080 Pixel benötigen eine proportional größere Mindestgröße.
- Es können verschiedene "detectionModel"-Werte angegeben werden. Informationen zum Verwenden und Vergleichen verschiedener Erkennungsmodelle finden Sie unter https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
Hinweis
-
- Abonnementkontingent des kostenlosen Tarifs: 1.000 Gesichter pro große Gesichtsliste.
- S0-Tarif-Abonnementkontingent: 1.000.000 Gesichter pro große Gesichtsliste.
POST {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}/persistedfaces
POST {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}/persistedfaces?_overload=addLargeFaceListFace&targetFace={targetFace}&detectionModel={detectionModel}&userData={userData}
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). |
large
|
path | True |
string |
Gültige Zeichen sind Kleinbuchstaben oder Ziffern oder "-" oder "_", die maximale Länge beträgt 64. Regex pattern: |
detection
|
query |
Das "detectionModel", das den erkannten FaceIds zugeordnet ist. Unterstützte "detectionModel"-Werte sind "detection_01", "detection_02" und "detection_03". Der Standardwert ist "detection_01". |
||
target
|
query |
integer[] |
Ein Gesichtsrechteck, um das Zielgesicht anzugeben, das einer Person im Format "targetFace=left,top,width,height" hinzugefügt werden soll. |
|
user
|
query |
string |
Vom Benutzer bereitgestellte Daten, die an das Gesicht angefügt sind. Das Größenlimit beträgt 1K. |
Anforderungstext
Media Types: "application/octet-stream"
Name | Typ | Beschreibung |
---|---|---|
imageContent |
string |
Das zu analysierende Bild |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Ein erfolgreicher Aufruf gibt eine neue persistedFaceId zurück. |
|
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
Add Face to LargeFaceList
Sample Request
POST {endpoint}/face/v1.1-preview.1/largefacelists/your_large_face_list_id/persistedfaces?_overload=addLargeFaceListFace&targetFace=10,10,100,100&detectionModel=detection_01&userData=your_user_data
"<your-image-bytes-here>"
Sample Response
{
"persistedFaceId": "43897a75-8d6f-42cf-885e-74832febb055"
}
Definitionen
Name | Beschreibung |
---|---|
Add |
Antworttext zum Hinzufügen von Gesicht. |
Detection |
Das "detectionModel", das den erkannten FaceIds zugeordnet ist. Unterstützte "detectionModel"-Werte sind "detection_01", "detection_02" und "detection_03". Der Standardwert ist "detection_01". |
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. |
AddFaceResult
Antworttext zum Hinzufügen von Gesicht.
Name | Typ | Beschreibung |
---|---|---|
persistedFaceId |
string |
Beibehaltene Gesichtserkennungs-ID des hinzugefügten Gesichts, die beibehalten wird und nicht abläuft. Anders als faceId, die in "Detect" erstellt wird und in 24 Stunden nach dem Erkennungsaufruf abläuft. |
DetectionModel
Das "detectionModel", das den erkannten FaceIds zugeordnet ist. Unterstützte "detectionModel"-Werte sind "detection_01", "detection_02" und "detection_03". Der Standardwert ist "detection_01".
Name | Typ | Beschreibung |
---|---|---|
detection_01 |
string |
Das Standarderkennungsmodell. Empfohlen für die Naherkennung des Frontalgesichts. Bei Szenarien mit außergewöhnlich großem Winkel (Kopfhaltung), verdeckten Gesichtern oder falscher Bildausrichtung werden die Gesichter in solchen Fällen möglicherweise nicht erkannt. |
detection_02 |
string |
Erkennungsmodell veröffentlicht im Mai 2019 mit verbesserter Genauigkeit, insbesondere auf kleinen, seiten- und verschwommenen Gesichtern. |
detection_03 |
string |
Erkennungsmodell im Februar 2021 mit verbesserter Genauigkeit, insbesondere bei kleinen Gesichtern. |
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. |