Azure AI Face API-foutcodes
Veelvoorkomende foutcodes
Deze foutcodes kunnen worden geretourneerd door alle Face-API-aanroepen.
| Http-statuscode | Foutcode | Foutmelding | Beschrijving |
|---|---|---|---|
| Ongeldige aanvraag (400) | BadArgument | Aanvraagbody is ongeldig. | |
| Ongeldige aanvraag (400) | BadArgument | JSON-parseringsfout. | Ongeldige of onherkenbare aanvraag-JSON-hoofdtekst. |
| Ongeldige aanvraag (400) | BadArgument | 'recognitionModel' is ongeldig. | |
| Ongeldige aanvraag (400) | BadArgument | 'detectionModel' is ongeldig. | |
| Ongeldige aanvraag (400) | BadArgument | 'naam' is leeg. | |
| Ongeldige aanvraag (400) | BadArgument | 'naam' is te lang. | |
| Ongeldige aanvraag (400) | BadArgument | 'userData' is te lang. | |
| Ongeldige aanvraag (400) | BadArgument | 'start' is te lang. | |
| Ongeldige aanvraag (400) | BadArgument | 'top' is ongeldig. | |
| Ongeldige aanvraag (400) | BadArgument | Argument targetFace buiten het bereik. | |
| Ongeldige aanvraag (400) | BadArgument | Ongeldig argument targetFace. | Veroorzaakt door ongeldige tekenreeksindeling of ongeldige waarde voor links/hoogste/hoogte/breedte. |
| Ongeldige aanvraag (400) | InvalidURL | Ongeldige afbeeldings-URL. | Ondersteunde indelingen zijn JPEG, PNG, GIF (het eerste frame) en BMP. |
| Ongeldige aanvraag (400) | InvalidURL | Ongeldige afbeeldings-URL of fout bij het downloaden van de doelserver. Fout bij externe server geretourneerd: 'Er is een fout opgetreden tijdens het verzenden van de aanvraag'. | |
| Ongeldige aanvraag (400) | InvalidImage | Decoderingsfout, afbeeldingsindeling wordt niet ondersteund. | |
| Ongeldige aanvraag (400) | InvalidImage | Er is geen gezicht gedetecteerd in de afbeelding. | |
| Ongeldige aanvraag (400) | InvalidImage | Er is meer dan 1 gezicht in de afbeelding. | |
| Ongeldige aanvraag (400) | InvalidImageSize | Het formaat van de afbeelding is te klein. | De geldige grootte van het afbeeldingsbestand moet groter zijn dan of gelijk zijn aan 1 kB. |
| Ongeldige aanvraag (400) | InvalidImageSize | Het formaat van de afbeelding is te groot. | De geldige grootte van het afbeeldingsbestand mag niet groter zijn dan 6 MB. |
| Niet-gemachtigd (401) | 401 | Toegang geweigerd vanwege een ongeldige abonnementssleutel of een onjuist API-eindpunt. Zorg ervoor dat u een geldige sleutel voor een actief abonnement opgeeft en gebruik een correct regionaal API-eindpunt voor uw resource. | |
| Verbonden (403) | UnsupportedFeature | De functie wordt niet ondersteund, er ontbreekt goedkeuring voor een of meer van de volgende functies: Identificatie, Verificatie. | Registreer u voor toegang door een registratieformulier in te dienen. |
| Conflict (409) | ConcurrentOperationConflict | Er is een conflictbewerking op de resource <resourceName>. Probeer het later opnieuw. |
|
| Te veel aanvragen (429) | 429 | De limiet wordt overschreden. |
Foutcodes voor gezichtsdetectie
Deze foutcodes kunnen worden geretourneerd door de bewerking Gezichtsdetectie.
Foutcodes voor Face Liveness Session
Deze foutcodes kunnen worden geretourneerd door face liveness session-bewerkingen.
| Http-statuscode | Foutcode | Foutmelding | Beschrijving |
|---|---|---|---|
| Ongeldige aanvraag (400) | BadArgument | De beginparameter is ongeldig. Geef het veld Id van het laatste item op om door te gaan met het vermeldingsproces. | |
| Ongeldige aanvraag (400) | BadArgument | De bovenste parameter is ongeldig. Geldig bereik is tussen 1 en 1000 inclusief. | |
| Ongeldige aanvraag (400) | InvalidRequestBody | Onjuiste aanvraagbody opgegeven. Controleer het bewerkingsschema en probeer het opnieuw. | |
| Ongeldige aanvraag (400) | InvalidTokenLifetime | Ongeldige authTokenTimeToLiveInSeconds opgegeven. Moet binnen 60 tot 86400 zijn. | |
| Ongeldige aanvraag (400) | InvalidLivenessOperationMode | Ongeldige livenessOperationMode opgegeven. Moet passief zijn. | |
| Ongeldige aanvraag (400) | InvalidDeviceCorrelationId | Een correlatie-id van het apparaat is vereist in de hoofdtekst van de aanvraag tijdens het maken of starten van de sessie. Mag niet null of leeg zijn en mag niet langer zijn dan 64 tekens. | |
| Niet gevonden (404) | SessionNotFound | De sessie-id is niet gevonden. De sessie-id is verlopen of bestaat niet. |
Foutcodes voor gezichts identificeren
Deze foutcodes kunnen worden geretourneerd door de bewerking Face Identify.
| Http-statuscode | Foutcode | Foutmelding | Beschrijving |
|---|---|---|---|
| Ongeldige aanvraag (400) | BadArgument | 'recognitionModel' is niet compatibel. | |
| Ongeldige aanvraag (400) | BadArgument | Groeps-id van persoon is ongeldig. | |
| Ongeldige aanvraag (400) | BadArgument | Groeps-id voor grote personen is ongeldig. | |
| Ongeldige aanvraag (400) | BadArgument | De groeps-id van dynamische persoon is ongeldig. | |
| Ongeldige aanvraag (400) | BadArgument | Het argument maxNumOfCandidatesReturned is ongeldig. | Het geldige bereik ligt tussen [1, 100]. |
| Ongeldige aanvraag (400) | BadArgument | Het argument confidenceThreshold is ongeldig. | Het geldige bereik ligt tussen [0, 1]. |
| Ongeldige aanvraag (400) | BadArgument | De lengte van faceIds bevindt zich niet in een geldig bereik. | Het geldige bereik ligt tussen [1, 10]. |
| Ongeldige aanvraag (400) | FaceNotFound | Gezicht is niet gevonden. | |
| Ongeldige aanvraag (400) | PersonGroupNotFound | De persoonsgroep is niet gevonden. | |
| Ongeldige aanvraag (400) | LargePersonGroupNotFound | Grote persoonsgroep is niet gevonden. | |
| Ongeldige aanvraag (400) | DynamicPersonGroupNotFound | Dynamische persoonsgroep is niet gevonden. | |
| Ongeldige aanvraag (400) | PersonGroupNotTrained | Persoonsgroep is niet getraind. | |
| Ongeldige aanvraag (400) | LargePersonGroupNotTrained | Grote personengroep is niet getraind. | |
| Ongeldige aanvraag (400) | PersonGroupIdAndLargePersonGroupIdBothNotNull | Groeps-id voor grote personen en groeps-id's voor personen zijn beide niet null. | |
| Ongeldige aanvraag (400) | PersonGroupIdAndLargePersonGroupIdBothNull | Groeps-id voor grote personen en groeps-id's voor personen zijn beide null. | |
| Ongeldige aanvraag (400) | MissingIdentificationScopeParameters | Er is geen parameter voor het identificatiebereik aanwezig in de aanvraag. | |
| Ongeldige aanvraag (400) | IncompatibleIdentificationScopeParametersCombination | Incompatibele parameters voor het identificatiebereik zijn aanwezig in de aanvraag. | |
| Conflict (409) | PersonGroupTrainingNotFinished | De persoonsgroep wordt getraind. | |
| Conflict (409) | LargePersonGroupTrainingNotFinished | Grote personengroep wordt getraind. |
Foutcodes voor gezichtsverificatie
Deze foutcodes kunnen worden geretourneerd door de bewerking Face Verify.
| Http-statuscode | Foutcode | Foutmelding | Beschrijving |
|---|---|---|---|
| Ongeldige aanvraag (400) | BadArgument | 'recognitionModel' is niet compatibel. | |
| Ongeldige aanvraag (400) | BadArgument | Face ID is ongeldig. | Een geldige faceId is afkomstig van Face - Detect. |
| Ongeldige aanvraag (400) | BadArgument | De persoons-id is ongeldig. | Er wordt een geldige personId gegenereerd op basis van Persoonsgroep maken, Groepslid voor grote personen of personenlijst maken - Persoon maken. |
| Ongeldige aanvraag (400) | BadArgument | Groeps-id van persoon is ongeldig. | |
| Ongeldige aanvraag (400) | BadArgument | Groeps-id voor grote personen is ongeldig. | |
| Ongeldige aanvraag (400) | PersonNotFound | De persoon is niet gevonden. | |
| Ongeldige aanvraag (400) | PersonGroupNotFound | Persoonsgroep is niet gevonden. | |
| Ongeldige aanvraag (400) | LargePersonGroupNotFound | Large Person Group is niet gevonden. | |
| Niet gevonden (404) | FaceNotFound | Gezicht is niet gevonden. | |
| Niet gevonden (404) | PersonNotFound | De persoon is niet gevonden. | |
| Niet gevonden (404) | PersistentedFaceNotFound | Er is geen persistent gezicht van de persoon gevonden. |
Vergelijkbare foutcodes zoeken
Deze foutcodes kunnen worden geretourneerd door de bewerking Face Find Similar.
| Http-statuscode | Foutcode | Foutmelding | Beschrijving |
|---|---|---|---|
| Ongeldige aanvraag (400) | BadArgument | 'recognitionModel' is niet compatibel. | |
| Ongeldige aanvraag (400) | BadArgument | De modus is ongeldig. | |
| Ongeldige aanvraag (400) | BadArgument | Gezichtslijst-id is ongeldig. | |
| Ongeldige aanvraag (400) | BadArgument | De id van de lijst met grote gezichten is ongeldig. | |
| Ongeldige aanvraag (400) | BadArgument | LargeFaceListId, faceListId en faceIds, niet precies een van deze is geldig. | |
| Ongeldige aanvraag (400) | BadArgument | LargeFaceListId, faceListId en faceIds zijn allemaal null. | |
| Ongeldige aanvraag (400) | BadArgument | 2 of meer largeFaceListId, faceListId en faceIds zijn niet null. | |
| Ongeldige aanvraag (400) | BadArgument | Het argument maxNumOfCandidatesReturned is ongeldig. | Het geldige bereik ligt tussen [1, 1000]. |
| Ongeldige aanvraag (400) | BadArgument | De lengte van faceIds bevindt zich niet in een geldig bereik. | Het geldige bereik ligt tussen [1, 1000]. |
| Ongeldige aanvraag (400) | FaceNotFound | Gezicht is niet gevonden. | |
| Ongeldige aanvraag (400) | FaceListNotFound | Gezichtslijst is niet gevonden. | |
| Ongeldige aanvraag (400) | LargeFaceListNotFound | De lijst met grote gezichten is niet gevonden. | |
| Ongeldige aanvraag (400) | LargeFaceListNotTrained | Grote gezichtslijst is niet getraind. | |
| Ongeldige aanvraag (400) | FaceListNotReady | De gezichtslijst is leeg. | |
| Conflict (409) | LargeFaceListTrainingNotFinished | Grote gezichtslijst staat onder training. |
Foutcodes voor gezichtsgroep
Deze foutcodes kunnen worden geretourneerd door de bewerking Face Group.
| Http-statuscode | Foutcode | Foutmelding | Beschrijving |
|---|---|---|---|
| Ongeldige aanvraag (400) | BadArgument | 'recognitionModel' is niet compatibel. | |
| Ongeldige aanvraag (400) | BadArgument | De lengte van faceIds bevindt zich niet in een geldig bereik. | Het geldige bereik ligt tussen [2, 1000]. |
Bewerkingen van personengroep
Deze foutcodes kunnen worden geretourneerd door bewerkingen van de persoonsgroep.
Foutcodes voor personengroep
| Http-statuscode | Foutcode | Foutmelding | Beschrijving |
|---|---|---|---|
| Ongeldige aanvraag (400) | BadArgument | Groeps-id van persoon is ongeldig. | Geldig teken is een Engelse letter in kleine letters, cijfers, '-' of '_'. De maximale lengte is 64. |
| Verbonden (403) | QuotaExceeded | Het groepsnummer van de persoon heeft de limiet voor abonnementsniveau bereikt. | |
| Verbonden (403) | QuotaExceeded | Het persoonsnummer heeft de limiet voor groepsniveau voor personen bereikt. | |
| Verbonden (403) | QuotaExceeded | Persoonsnummer heeft de limiet voor abonnementsniveau bereikt. | |
| Verbonden (403) | QuotaExceeded | Het permanente gezichtsnummer heeft de limiet bereikt. | |
| Niet gevonden (404) | PersonGroupNotFound | De persoonsgroep is niet gevonden. | |
| Niet gevonden (404) | PersonGroupNotFound | Groeps-id van persoon is ongeldig. | |
| Niet gevonden (404) | PersonNotFound | De persoon <personId> is niet gevonden. |
|
| Niet gevonden (404) | PersonNotFound | De persoons-id is ongeldig. | |
| Niet gevonden (404) | PersistentedFaceNotFound | Persistent gezicht is niet gevonden. | |
| Niet gevonden (404) | PersistentedFaceNotFound | Persistent gezicht <faceId> is niet gevonden. |
|
| Niet gevonden (404) | PersistentedFaceNotFound | Persistente gezichts-id is ongeldig. | |
| Niet gevonden (404) | PersonGroupNotTrained | Persoonsgroep is niet getraind. | Deze fout wordt weergegeven bij het ophalen van de trainingsstatus van een groep die nooit is getraind. |
| Conflict (409) | PersonGroupExists | Persoonsgroep bestaat al. | |
| Conflict (409) | PersonGroupTrainingNotFinished | De persoonsgroep wordt getraind. | Probeer het opnieuw nadat de training is voltooid. |
Foutcodes voor grote personengroep
| Http-statuscode | Foutcode | Foutmelding | Beschrijving |
|---|---|---|---|
| Ongeldige aanvraag (400) | BadArgument | Groeps-id voor grote personen is ongeldig. | Geldig teken is een Engelse letter in kleine letters, cijfers, '-' of '_'. De maximale lengte is 64. |
| Ongeldige aanvraag (400) | BadArgument | Zowel 'name' als 'userData' zijn leeg. | |
| Verbonden (403) | QuotaExceeded | Het groepsnummer voor grote personen bereikt de limiet op abonnementsniveau. | |
| Verbonden (403) | QuotaExceeded | Het aantal personen bereikt limiet op groepsniveau voor grote personen. | |
| Verbonden (403) | QuotaExceeded | Persoonsnummer heeft de limiet voor abonnementsniveau bereikt. | |
| Verbonden (403) | QuotaExceeded | Het permanente gezichtsnummer heeft de limiet bereikt. | |
| Niet gevonden (404) | LargePersonGroupNotFound | Grote persoonsgroep is niet gevonden. | |
| Niet gevonden (404) | LargePersonGroupNotFound | Groeps-id voor grote personen is ongeldig. | |
| Niet gevonden (404) | PersonNotFound | De persoon <personId> is niet gevonden. |
|
| Niet gevonden (404) | PersonNotFound | De persoons-id is ongeldig. | |
| Niet gevonden (404) | PersistentedFaceNotFound | Persistent gezicht is niet gevonden. | |
| Niet gevonden (404) | PersistentedFaceNotFound | Persistent gezicht <faceId> is niet gevonden. |
|
| Niet gevonden (404) | PersistentedFaceNotFound | Persistente gezichts-id is ongeldig. | |
| Niet gevonden (404) | LargePersonGroupNotTrained | Grote personengroep is niet getraind. | Deze fout wordt weergegeven bij het ophalen van de trainingsstatus van een groep die nooit is getraind. |
| Conflict (409) | LargePersonGroupExists | Groep grote personen bestaat al. | |
| Conflict (409) | LargePersonGroupTrainingNotFinished | Grote personengroep wordt getraind. | Probeer het opnieuw nadat de training is voltooid. |
Bewerkingen voor gezichtslijst
Deze foutcodes kunnen worden geretourneerd door gezichtslijstbewerkingen.
Foutcodes voor Gezichtslijst
| Http-statuscode | Foutcode | Foutmelding | Beschrijving |
|---|---|---|---|
| Ongeldige aanvraag (400) | BadArgument | Gezichtslijst-id is ongeldig. | Geldig teken is een Engelse letter in kleine letters, cijfers, '-' of '_'. De maximale lengte is 64. |
| Verbonden (403) | QuotaExceeded | Het permanente gezichtsnummer heeft de limiet bereikt. | |
| Niet gevonden (404) | FaceListNotFound | Gezichtslijst is niet gevonden. | |
| Niet gevonden (404) | FaceListNotFound | Gezichtslijst-id is ongeldig. | |
| Niet gevonden (404) | PersistentedFaceNotFound | Persistent gezicht is niet gevonden. | |
| Niet gevonden (404) | PersistentedFaceNotFound | Persistente gezichts-id is ongeldig. | |
| Conflict (409) | FaceListExists | De gezichtslijst bestaat al. |
Foutcodes voor grote gezichtslijst
| Http-statuscode | Foutcode | Foutmelding | Beschrijving |
|---|---|---|---|
| Ongeldige aanvraag (400) | BadArgument | De id van de lijst met grote gezichten is ongeldig. | Geldig teken is een Engelse letter in kleine letters, cijfers, '-' of '_'. De maximale lengte is 64. |
| Ongeldige aanvraag (400) | BadArgument | Zowel 'name' als 'userData' zijn leeg. | |
| Verbonden (403) | QuotaExceeded | Het nummer van de grote gezichtslijst is bereikt. | |
| Verbonden (403) | QuotaExceeded | Het permanente gezichtsnummer heeft de limiet bereikt. | |
| Niet gevonden (404) | LargeFaceListNotFound | De lijst met grote gezichten is niet gevonden. | |
| Niet gevonden (404) | LargeFaceListNotFound | De id van de lijst met grote gezichten is ongeldig. | |
| Niet gevonden (404) | PersistentedFaceNotFound | Large Face List Face <faceId> is niet gevonden. |
|
| Niet gevonden (404) | PersistentedFaceNotFound | Persistente gezichts-id is ongeldig. | |
| Niet gevonden (404) | LargeFaceListNotTrained | Grote gezichtslijst is niet getraind. | Deze fout wordt weergegeven bij het ophalen van de trainingsstatus van een grote gezichtslijst die nooit is getraind. |
| Conflict (409) | LargeFaceListExists | Er bestaat al een grote gezichtslijst. | |
| Conflict (409) | LargeFaceListTrainingNotFinished | Grote gezichtslijst staat onder training. | Probeer het opnieuw nadat de training is voltooid. |
Bewerkingen van personendirectory
Deze foutcodes kunnen worden geretourneerd door Person Directory-bewerkingen.
Foutcodes voor persoonsmap
| Http-statuscode | Foutcode | Foutmelding | Beschrijving |
|---|---|---|---|
| Ongeldige aanvraag (400) | BadArgument | Het herkenningsmodel wordt niet ondersteund voor deze functie. | |
| Ongeldige aanvraag (400) | BadArgument | 'start' is geen geldige persoons-id. | |
| Ongeldige aanvraag (400) | BadArgument | Zowel 'name' als 'userData' zijn leeg. | |
| Ongeldige aanvraag (400) | DynamicPersonGroupNotFound | De groeps-id van dynamische persoon is ongeldig. | |
| Verbonden (403) | QuotaExceeded | Persoonsnummer heeft de limiet voor abonnementsniveau bereikt. | |
| Verbonden (403) | QuotaExceeded | Het permanente gezichtsnummer heeft de limiet bereikt. | |
| Niet gevonden (404) | DynamicPersonGroupNotFound | Er is geen dynamische persoonsgroep gevonden. | |
| Niet gevonden (404) | DynamicPersonGroupNotFound | DynamicPersonGroupPersonReference <groupId> is niet gevonden. |
|
| Niet gevonden (404) | PersonNotFound | De persoon is niet gevonden. | |
| Niet gevonden (404) | PersonNotFound | De persoons-id is ongeldig. | |
| Niet gevonden (404) | PersistentedFaceNotFound | Persistent gezicht is niet gevonden. | |
| Niet gevonden (404) | PersistentedFaceNotFound | Persistent gezicht <faceId> is niet gevonden. |
|
| Niet gevonden (404) | PersistentedFaceNotFound | Persistente Face ID is ongeldig. | |
| Conflict (409) | DynamicPersonGroupExists | De groeps-id <groupId> van dynamische persoon bestaat al. |
Volgende stappen
- Naslagmateriaal over de Face-API (Engelstalig)