Delen via

Azure AI Face API-foutcodes

  • Artikel

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.

Http-statuscode Foutcode Foutmelding Beschrijving
Ongeldige aanvraag (400) BadArgument Ongeldig argument returnFaceAttributes.
Ongeldige aanvraag (400) BadArgument 'returnFaceAttributes' wordt niet ondersteund door detection_02.
Ongeldige aanvraag (400) BadArgument 'returnLandmarks' wordt niet ondersteund door detection_02.
Verbonden (403) UnsupportedFeature Retourkenmerken (emotie, geslacht, leeftijd, glimlach, gezichtshaar, haar en make-up) zijn afgeschaft en worden niet meer ondersteund. Lees hier meer over deze beslissing.

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