Azure AI Face API-Fehlercodes
Häufige Fehlermeldungen
Diese Fehlercodes können von allen Face-API-Aufrufen zurückgegeben werden.
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | Der Anforderungstext ist ungültig. | |
| Ungültige Anforderung (400) | BadArgument | JSON-Analysefehler. | Ungültiger oder nicht erkennbarer JSON-Anforderungstext. |
| Ungültige Anforderung (400) | BadArgument | „recognitionModel“ ist falsch. | |
| Ungültige Anforderung (400) | BadArgument | „detectionModel“ ist falsch. | |
| Ungültige Anforderung (400) | BadArgument | "Name" ist leer. | |
| Ungültige Anforderung (400) | BadArgument | "Name" ist zu lang. | |
| Ungültige Anforderung (400) | BadArgument | "userData" ist zu lang. | |
| Ungültige Anforderung (400) | BadArgument | "Start" ist zu lang. | |
| Ungültige Anforderung (400) | BadArgument | "top" ist ungültig. | |
| Ungültige Anforderung (400) | BadArgument | Argument targetFace außerhalb des Bereichs. | |
| Ungültige Anforderung (400) | BadArgument | Ungültiges Argument targetFace. | Wird durch ein ungültiges Zeichenfolgenformat oder einen ungültigen Wert für links/oben/höhe/breite verursacht. |
| Ungültige Anforderung (400) | InvalidURL | Ungültige Bild-URL. | Als Formate werden JPEG, PNG, GIF (der erste Frame) und BMP unterstützt. |
| Ungültige Anforderung (400) | InvalidURL | Ungültige Bild-URL oder Fehler beim Herunterladen vom Zielserver. Remoteserverfehler zurückgegeben: "Fehler beim Senden der Anforderung." | |
| Ungültige Anforderung (400) | InvalidImage | Decodierungsfehler, Bildformat nicht unterstützt. | |
| Ungültige Anforderung (400) | InvalidImage | Im Bild wurde kein Gesicht erkannt. | |
| Ungültige Anforderung (400) | InvalidImage | Es gibt mehr als 1 Gesicht im Bild. | |
| Ungültige Anforderung (400) | InvalidImageSize | Die Bildgröße ist zu klein. | Die gültige Bilddatei sollte größer oder gleich 1 KB sein. |
| Ungültige Anforderung (400) | InvalidImageSize | Die Bildgröße ist zu groß. | Die gültige Bilddatei sollte nicht größer als 6 MB sein. |
| Nicht autorisiert (401) | 401 | Der Zugriff wurde aufgrund eines ungültigen Abonnementschlüssels oder eines falschen API-Endpunkts verweigert. Stellen Sie sicher, dass Sie einen gültigen Schlüssel für ein aktives Abonnement bereitstellen und einen richtigen regionalen API-Endpunkt für Ihre Ressource verwenden. | |
| Unzulässig (403) | UnsupportedFeature | Das Feature wird nicht unterstützt, fehlende Genehmigung für eine oder mehrere der folgenden Features: Identifikation, Überprüfung. | Registrieren Sie sich für den Zugriff, indem Sie ein Registrierungsformular übermitteln. |
| Konflikt (409) | ConcurrentOperationConflict | Es ist ein Konfliktvorgang für die Ressource <resourceName>vorhanden. Versuchen Sie es bitte später. |
|
| Zu viele Anforderungen (429) | 429 | Die Durchsatzgrenze wurde überschritten. |
Fehlercodes für die Gesichtserkennung
Diese Fehlercodes können vom Gesichtserkennungsvorgang zurückgegeben werden.
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | Ungültiges Argument returnFaceAttributes. | |
| Ungültige Anforderung (400) | BadArgument | „returnFaceAttributes“ wird von detection_02 nicht unterstützt. | |
| Ungültige Anforderung (400) | BadArgument | „returnLandmarks“ wird von detection_02 nicht unterstützt. | |
| Unzulässig (403) | UnsupportedFeature | Rückgabeattribute (Emotion, Geschlecht, Alter, Lächeln, Gesichtshaare, Haar und Make-up) sind veraltet und werden nicht mehr unterstützt. | Senden Sie eine E-Mail an das Team für die Azure-Gesichtserkennung, wenn Sie einen verantwortungsvollen Anwendungsfall haben, der von der Verwendung einer der eingeschränkten Funktionen profitieren würde. |
Fehlercodes für Die Livenesssitzung
Diese Fehlercodes können von Face Liveness Session-Vorgängen zurückgegeben werden.
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | Der Startparameter ist ungültig. Geben Sie das Feld "ID" des letzten Eintrags an, um den Eintragsvorgang fortzusetzen. | |
| Ungültige Anforderung (400) | BadArgument | Der top-Parameter ist ungültig. Gültiger Bereich liegt zwischen 1 und 1000 einschließlich. | |
| Ungültige Anforderung (400) | InvalidRequestBody | Falscher Anforderungstext angegeben. Überprüfen Sie das Vorgangsschema, und versuchen Sie es erneut. | |
| Ungültige Anforderung (400) | InvalidTokenLifetime | Ungültige authTokenTimeToLiveInSeconds angegeben. Muss innerhalb von 60 bis 86400 sein. | |
| Ungültige Anforderung (400) | InvalidLivenessOperationMode | Ungültiger livenessOperationMode-Wert. Muss "Passiv" sein. | |
| Ungültige Anforderung (400) | InvalidDeviceCorrelationId | Eine Gerätekorrelations-ID ist im Anforderungstext während der Sitzungserstellung oder sitzungsanfang erforderlich. Darf nicht null oder leer sein und darf nicht mehr als 64 Zeichen lang sein. | |
| Nicht gefunden (404) | SessionNotFound | Die Sitzungs-ID wurde nicht gefunden. Die Sitzungs-ID ist abgelaufen oder ist nicht vorhanden. |
Fehlercodes für die Gesichts-Identifizierung
Diese Fehlercodes können vom Face Identify-Vorgang zurückgegeben werden.
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | "recognitionModel" ist inkompatibel. | |
| Ungültige Anforderung (400) | BadArgument | Die Personengruppen-ID ist ungültig. | |
| Ungültige Anforderung (400) | BadArgument | Die Gruppen-ID für große Personen ist ungültig. | |
| Ungültige Anforderung (400) | BadArgument | Dynamische Personengruppen-ID ist ungültig. | |
| Ungültige Anforderung (400) | BadArgument | Das Argument maxNumOfCandidatesReturned ist ungültig. | Der gültige Bereich liegt zwischen [1, 100]. |
| Ungültige Anforderung (400) | BadArgument | Das Argument confidenceThreshold ist ungültig. | Der gültige Bereich liegt zwischen [0, 1]. |
| Ungültige Anforderung (400) | BadArgument | Die Länge von faceIds befindet sich nicht in einem gültigen Bereich. | Der gültige Bereich liegt zwischen [1, 10]. |
| Ungültige Anforderung (400) | FaceNotFound | Das Gesicht wurde nicht gefunden. | |
| Ungültige Anforderung (400) | PersonGroupNotFound | Die Personengruppe wurde nicht gefunden. | |
| Ungültige Anforderung (400) | LargePersonGroupNotFound | Große Personengruppe wurde nicht gefunden. | |
| Ungültige Anforderung (400) | DynamicPersonGroupNotFound | Dynamische Personengruppe wurde nicht gefunden. | |
| Ungültige Anforderung (400) | PersonGroupNotTrained | Personengruppe nicht trainiert. | |
| Ungültige Anforderung (400) | LargePersonGroupNotTrained | Große Personengruppe wurde nicht trainiert. | |
| Ungültige Anforderung (400) | PersonGroupIdAndLargePersonGroupIdBothNotNull | Die Gruppen-ID für große Personen und die Gruppen-ID für große Personen sind nicht null. | |
| Ungültige Anforderung (400) | PersonGroupIdAndLargePersonGroupIdBothNull | Die Gruppen-ID für große Personen und die Gruppen-ID für große Personen sind beide NULL. | |
| Ungültige Anforderung (400) | MissingIdentificationScopeParameters | In der Anforderung ist kein Identifikationsbereichsparameter vorhanden. | |
| Ungültige Anforderung (400) | InkompatibleIdentificationScopeParametersCombination | Inkompatible Identifikationsbereichsparameter sind in der Anforderung vorhanden. | |
| Konflikt (409) | PersonGroupTrainingNotFinished | Die Personengruppe befindet sich in der Ausbildung. | |
| Konflikt (409) | LargePersonGroupTrainingNotFinished | Große Personengruppe befindet sich im Training. |
Fehlercodes für die Gesichtsüberprüfung
Diese Fehlercodes können vom Face Verify-Vorgang zurückgegeben werden.
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | "recognitionModel" ist inkompatibel. | |
| Ungültige Anforderung (400) | BadArgument | Die Gesichts-ID ist ungültig. | Eine gültige FaceId stammt von Face - Detect. |
| Ungültige Anforderung (400) | BadArgument | Die Personen-ID ist ungültig. | Eine gültige personId wird aus "Person-Gruppenperson erstellen", "Person erstellen" oder "Person verzeichnis erstellen" generiert. |
| Ungültige Anforderung (400) | BadArgument | Die Personengruppen-ID ist ungültig. | |
| Ungültige Anforderung (400) | BadArgument | Die Gruppen-ID für große Personen ist ungültig. | |
| Ungültige Anforderung (400) | PersonNotFound | Die Person wurde nicht gefunden. | |
| Ungültige Anforderung (400) | PersonGroupNotFound | Die Personengruppe wurde nicht gefunden. | |
| Ungültige Anforderung (400) | LargePersonGroupNotFound | Große Personengruppe wurde nicht gefunden. | |
| Nicht gefunden (404) | FaceNotFound | Das Gesicht wurde nicht gefunden. | |
| Nicht gefunden (404) | PersonNotFound | Die Person wurde nicht gefunden. | |
| Nicht gefunden (404) | PersistedFaceNotFound | Es wurde kein permanentes Gesicht der Person gefunden. |
Ähnliche Fehlercodes suchen
Diese Fehlercodes können durch den Face Find Similar-Vorgang zurückgegeben werden.
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | "recognitionModel" ist inkompatibel. | |
| Ungültige Anforderung (400) | BadArgument | Der Modus ist ungültig. | |
| Ungültige Anforderung (400) | BadArgument | Die Gesichtslisten-ID ist ungültig. | |
| Ungültige Anforderung (400) | BadArgument | Die ID für große Gesichtslisten ist ungültig. | |
| Ungültige Anforderung (400) | BadArgument | LargeFaceListId, faceListId und faceIds, nicht genau einer davon ist gültig. | |
| Ungültige Anforderung (400) | BadArgument | LargeFaceListId, faceListId und faceIds sind alle null. | |
| Ungültige Anforderung (400) | BadArgument | 2 oder mehr von largeFaceListId, faceListId und faceIds sind nicht NULL. | |
| Ungültige Anforderung (400) | BadArgument | Das Argument maxNumOfCandidatesReturned ist ungültig. | Der gültige Bereich liegt zwischen [1, 1000]. |
| Ungültige Anforderung (400) | BadArgument | Die Länge von faceIds befindet sich nicht in einem gültigen Bereich. | Der gültige Bereich liegt zwischen [1, 1000]. |
| Ungültige Anforderung (400) | FaceNotFound | Das Gesicht wurde nicht gefunden. | |
| Ungültige Anforderung (400) | FaceListNotFound | Die Gesichtsliste wurde nicht gefunden. | |
| Ungültige Anforderung (400) | LargeFaceListNotFound | Große Gesichtsliste wurde nicht gefunden. | |
| Ungültige Anforderung (400) | LargeFaceListNotTrained | Große Gesichtsliste ist nicht trainiert. | |
| Ungültige Anforderung (400) | FaceListNotReady | Die Gesichtsliste ist leer. | |
| Konflikt (409) | LargeFaceListTrainingNotFinished | Die große Gesichtsliste befindet sich in der Schulung. |
Fehlercodes für Die Gesichtsgruppe
Diese Fehlercodes können vom Face Group-Vorgang zurückgegeben werden.
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | "recognitionModel" ist inkompatibel. | |
| Ungültige Anforderung (400) | BadArgument | Die Länge von faceIds befindet sich nicht in einem gültigen Bereich. | Der gültige Bereich liegt zwischen [2, 1000]. |
Personengruppenvorgänge
Diese Fehlercodes können von Personengruppenvorgängen zurückgegeben werden.
Fehlercodes für Personengruppen
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | Die Personengruppen-ID ist ungültig. | Gültiges Zeichen ist englischer Buchstabe in Kleinbuchstaben, Ziffern, '-' oder '_'. Die maximale Länge beträgt 64. |
| Unzulässig (403) | QuotaExceeded | Die Anzahl der Personengruppen hat das Limit der Abonnementebene erreicht. | |
| Unzulässig (403) | QuotaExceeded | Die Personennummer hat das Limit der Personengruppenebene erreicht. | |
| Unzulässig (403) | QuotaExceeded | Die Personennummer hat das Limit der Abonnementebene erreicht. | |
| Unzulässig (403) | QuotaExceeded | Grenzwert für beibehaltene Gesichtsnummern erreicht. | |
| Nicht gefunden (404) | PersonGroupNotFound | Die Personengruppe wurde nicht gefunden. | |
| Nicht gefunden (404) | PersonGroupNotFound | Die Personengruppen-ID ist ungültig. | |
| Nicht gefunden (404) | PersonNotFound | Die Person <personId> wurde nicht gefunden. |
|
| Nicht gefunden (404) | PersonNotFound | Die Personen-ID ist ungültig. | |
| Nicht gefunden (404) | PersistedFaceNotFound | Das beibehaltene Gesicht wurde nicht gefunden. | |
| Nicht gefunden (404) | PersistedFaceNotFound | Das beibehaltene Gesicht <faceId> wurde nicht gefunden. |
|
| Nicht gefunden (404) | PersistedFaceNotFound | Die beibehaltene Gesichts-ID ist ungültig. | |
| Nicht gefunden (404) | PersonGroupNotTrained | Personengruppe nicht trainiert. | Dieser Fehler tritt auf, um den Schulungsstatus einer Gruppe zu erhalten, die nie trainiert wurde. |
| Konflikt (409) | PersonGroupExists | Personengruppe ist bereits vorhanden. | |
| Konflikt (409) | PersonGroupTrainingNotFinished | Die Personengruppe befindet sich in der Ausbildung. | Versuchen Sie es nach Abschluss der Schulung erneut. |
Fehlercodes für große Personengruppe
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | Die Gruppen-ID für große Personen ist ungültig. | Gültiges Zeichen ist englischer Buchstabe in Kleinbuchstaben, Ziffern, '-' oder '_'. Die maximale Länge beträgt 64. |
| Ungültige Anforderung (400) | BadArgument | Sowohl 'name' als auch 'userData' sind leer. | |
| Unzulässig (403) | QuotaExceeded | Die Anzahl der großen Personengruppen hat das Limit auf Abonnementebene erreicht. | |
| Unzulässig (403) | QuotaExceeded | Die Personenzahl hat den Grenzwert für große Personengruppen erreicht. | |
| Unzulässig (403) | QuotaExceeded | Die Personennummer hat das Limit der Abonnementebene erreicht. | |
| Unzulässig (403) | QuotaExceeded | Grenzwert für beibehaltene Gesichtsnummern erreicht. | |
| Nicht gefunden (404) | LargePersonGroupNotFound | Große Personengruppe wurde nicht gefunden. | |
| Nicht gefunden (404) | LargePersonGroupNotFound | Die Gruppen-ID für große Personen ist ungültig. | |
| Nicht gefunden (404) | PersonNotFound | Die Person <personId> wurde nicht gefunden. |
|
| Nicht gefunden (404) | PersonNotFound | Die Personen-ID ist ungültig. | |
| Nicht gefunden (404) | PersistedFaceNotFound | Das beibehaltene Gesicht wurde nicht gefunden. | |
| Nicht gefunden (404) | PersistedFaceNotFound | Das beibehaltene Gesicht <faceId> wurde nicht gefunden. |
|
| Nicht gefunden (404) | PersistedFaceNotFound | Die beibehaltene Gesichts-ID ist ungültig. | |
| Nicht gefunden (404) | LargePersonGroupNotTrained | Große Personengruppe wurde nicht trainiert. | Dieser Fehler tritt auf, um den Schulungsstatus einer Gruppe zu erhalten, die nie trainiert wurde. |
| Konflikt (409) | LargePersonGroupExists | Große Personengruppe ist bereits vorhanden. | |
| Konflikt (409) | LargePersonGroupTrainingNotFinished | Große Personengruppe befindet sich im Training. | Versuchen Sie es nach Abschluss der Schulung erneut. |
Face List-Vorgänge
Diese Fehlercodes können von Face List-Vorgängen zurückgegeben werden.
Fehlercodes für Die Gesichtsliste
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | Die Gesichtslisten-ID ist ungültig. | Gültiges Zeichen ist englischer Buchstabe in Kleinbuchstaben, Ziffern, '-' oder '_'. Die maximale Länge beträgt 64. |
| Unzulässig (403) | QuotaExceeded | Grenzwert für beibehaltene Gesichtsnummern erreicht. | |
| Nicht gefunden (404) | FaceListNotFound | Die Gesichtsliste wurde nicht gefunden. | |
| Nicht gefunden (404) | FaceListNotFound | Die Gesichtslisten-ID ist ungültig. | |
| Nicht gefunden (404) | PersistedFaceNotFound | Das beibehaltene Gesicht wurde nicht gefunden. | |
| Nicht gefunden (404) | PersistedFaceNotFound | Die beibehaltene Gesichts-ID ist ungültig. | |
| Konflikt (409) | FaceListExists | Die Gesichtsliste ist bereits vorhanden. |
Fehlercodes für große Gesichtsliste
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | Die ID für große Gesichtslisten ist ungültig. | Gültiges Zeichen ist englischer Buchstabe in Kleinbuchstaben, Ziffern, '-' oder '_'. Die maximale Länge beträgt 64. |
| Ungültige Anforderung (400) | BadArgument | Sowohl 'name' als auch 'userData' sind leer. | |
| Unzulässig (403) | QuotaExceeded | Die Anzahl der großen Gesichtslisten wurde erreicht. | |
| Unzulässig (403) | QuotaExceeded | Grenzwert für beibehaltene Gesichtsnummern erreicht. | |
| Nicht gefunden (404) | LargeFaceListNotFound | Große Gesichtsliste wurde nicht gefunden. | |
| Nicht gefunden (404) | LargeFaceListNotFound | Die ID für große Gesichtslisten ist ungültig. | |
| Nicht gefunden (404) | PersistedFaceNotFound | Das face list large face <faceId> is not found. |
|
| Nicht gefunden (404) | PersistedFaceNotFound | Die beibehaltene Gesichts-ID ist ungültig. | |
| Nicht gefunden (404) | LargeFaceListNotTrained | Große Gesichtsliste nicht trainiert. | Dieser Fehler tritt auf, um den Schulungsstatus einer großen Gesichtsliste zu erhalten, die nie trainiert wurde. |
| Konflikt (409) | LargeFaceListExists | Es ist bereits eine große Gesichtsliste vorhanden. | |
| Konflikt (409) | LargeFaceListTrainingNotFinished | Die große Gesichtsliste befindet sich in der Schulung. | Versuchen Sie es nach Abschluss der Schulung erneut. |
Personenverzeichnisvorgänge
Diese Fehlercodes können von Personenverzeichnisvorgängen zurückgegeben werden.
Fehlercodes für das Personenverzeichnis
| Http-Statuscode | Fehlercode | Fehlermeldung | Beschreibung |
|---|---|---|---|
| Ungültige Anforderung (400) | BadArgument | Das Erkennungsmodell wird für dieses Feature nicht unterstützt. | |
| Ungültige Anforderung (400) | BadArgument | "start" ist keine gültige Personen-ID. | |
| Ungültige Anforderung (400) | BadArgument | Sowohl 'name' als auch 'userData' sind leer. | |
| Ungültige Anforderung (400) | DynamicPersonGroupNotFound | Dynamische Personengruppen-ID ist ungültig. | |
| Unzulässig (403) | QuotaExceeded | Die Personennummer hat das Limit der Abonnementebene erreicht. | |
| Unzulässig (403) | QuotaExceeded | Grenzwert für beibehaltene Gesichtsnummern erreicht. | |
| Nicht gefunden (404) | DynamicPersonGroupNotFound | Dynamische Personengruppe wurde nicht gefunden. | |
| Nicht gefunden (404) | DynamicPersonGroupNotFound | DynamicPersonGroupPersonReference <groupId> wurde nicht gefunden. |
|
| Nicht gefunden (404) | PersonNotFound | Die Person wurde nicht gefunden. | |
| Nicht gefunden (404) | PersonNotFound | Die Personen-ID ist ungültig. | |
| Nicht gefunden (404) | PersistedFaceNotFound | Das beibehaltene Gesicht wurde nicht gefunden. | |
| Nicht gefunden (404) | PersistedFaceNotFound | Das beibehaltene Gesicht <faceId> wurde nicht gefunden. |
|
| Nicht gefunden (404) | PersistedFaceNotFound | Die beibehaltene Gesichts-ID ist ungültig. | |
| Konflikt (409) | DynamicPersonGroupExists | Dynamische Personengruppen-ID <groupId> ist bereits vorhanden. |
Nächste Schritte