Dela via

Felkoder för Ansikts-API för Azure AI

  • Artikel

Vanliga felkoder

Dessa felkoder kan returneras av alla Ansikts-API-anrop.

Http-statuskod Felkod Felmeddelande beskrivning
Felaktig begäran (400) BadArgument Begärandetexten är ogiltig.
Felaktig begäran (400) BadArgument JSON-parsningsfel. Felaktig eller oigenkännlig begärande-JSON-brödtext.
Felaktig begäran (400) BadArgument "recognitionModel" är ogiltig.
Felaktig begäran (400) BadArgument "detectionModel" är ogiltig.
Felaktig begäran (400) BadArgument Namnet är tomt.
Felaktig begäran (400) BadArgument namnet är för långt.
Felaktig begäran (400) BadArgument UserData är för långt.
Felaktig begäran (400) BadArgument "start" är för lång.
Felaktig begäran (400) BadArgument "top" är ogiltig.
Felaktig begäran (400) BadArgument ArgumentmålAnsikte utom intervallet.
Felaktig begäran (400) BadArgument Ogiltigt argumentmålFace. Orsakas av ogiltigt strängformat eller ogiltigt värde för vänster/överkant/höjd/bredd.
Felaktig begäran (400) InvalidURL Ogiltig bild-URL. Format som stöds är JPEG, PNG, GIF (den första ramen) och BMP.
Felaktig begäran (400) InvalidURL Ogiltig bild-URL eller fel vid nedladdning från målservern. Fjärrserverfel returnerades: "Ett fel uppstod när begäran skickades."
Felaktig begäran (400) InvalidImage Avkodningsfel, avbildningsformat som inte stöds.
Felaktig begäran (400) InvalidImage Inget ansikte har identifierats i bilden.
Felaktig begäran (400) InvalidImage Det finns mer än 1 ansikte i bilden.
Felaktig begäran (400) InvalidImageSize Bildstorleken är för liten. Den giltiga bildfilstorleken ska vara större än eller lika med 1 KB.
Felaktig begäran (400) InvalidImageSize Bildstorleken är för stor. Den giltiga bildfilstorleken får inte vara större än 6 MB.
Ej behörig (401) 401 Åtkomst nekad på grund av ogiltig prenumerationsnyckel eller fel API-slutpunkt. Se till att ange en giltig nyckel för en aktiv prenumeration och använd en korrekt regional API-slutpunkt för resursen.
Förbjudet (403) UnsupportedFeature Funktionen stöds inte och godkännande saknas för en eller flera av följande funktioner: Identifiering, verifiering. Registrera dig för åtkomst genom att skicka ett registreringsformulär.
Konflikt (409) ConcurrentOperationConflict Det finns en konfliktåtgärd på resursen <resourceName>. Försök senare.
För många begäranden (429) 429 Hastighetsbegränsning överskriden.

Felkoder för ansiktsigenkänning

Dessa felkoder kan returneras av ansiktsigenkänningsåtgärden.

Http-statuskod Felkod Felmeddelande beskrivning
Felaktig begäran (400) BadArgument Ogiltigt argument returnFaceAttributes.
Felaktig begäran (400) BadArgument "returnFaceAttributes" stöds inte av detection_02.
Felaktig begäran (400) BadArgument "returnLandmarks" stöds inte av detection_02.
Förbjudet (403) UnsupportedFeature Return Attribut (känsla, kön, ålder, leende, ansiktshår, hår och smink) har föråldrats och stöds inte längre. Skicka ett e-postmeddelande till Azure Face-teamet om du har ett ansvarsfullt användningsfall som kan dra nytta av någon av de begränsade funktionerna.

Felkoder för Face Liveness-session

Dessa felkoder kan returneras av sessionsåtgärder för ansiktsuppekomst.

Http-statuskod Felkod Felmeddelande beskrivning
Felaktig begäran (400) BadArgument Startparametern är ogiltig. Ange fältet ID för den senaste posten för att fortsätta listningsprocessen.
Felaktig begäran (400) BadArgument Den översta parametern är ogiltig. Giltigt intervall är mellan 1 och 1 000 inklusive.
Felaktig begäran (400) InvalidRequestBody Felaktig begärandetext har angetts. Kontrollera åtgärdsschemat och försök igen.
Felaktig begäran (400) InvalidTokenLifetime Ogiltiga authTokenTimeToLiveInSeconds har angetts. Måste vara mellan 60 och 86400.
Felaktig begäran (400) InvalidLivenessOperationMode Ogiltig livenessOperationMode har angetts. Måste vara "passiv".
Felaktig begäran (400) InvalidDeviceCorrelationId Ett enhetskorrelations-ID krävs i begärandetexten under sessionsskapandet eller sessionsstarten. Får inte vara null eller tom och får inte innehålla fler än 64 tecken.
Hittades inte (404) SessionNotFound Sessions-ID hittades inte. Sessions-ID:t har upphört att gälla eller finns inte.

Felkoder för ansiktsigenkänning

Dessa felkoder kan returneras av åtgärden Ansiktsigenkänning.

Http-statuskod Felkod Felmeddelande beskrivning
Felaktig begäran (400) BadArgument "recognitionModel" är inkompatibel.
Felaktig begäran (400) BadArgument Persongrupp-ID är ogiltigt.
Felaktig begäran (400) BadArgument Grupp-ID för stora personer är ogiltigt.
Felaktig begäran (400) BadArgument Grupp-ID för dynamisk person är ogiltigt.
Felaktig begäran (400) BadArgument Argumentet maxNumOfCandidatesReturned är inte giltigt. Det giltiga intervallet är mellan [1, 100].
Felaktig begäran (400) BadArgument Argumentet confidenceThreshold är inte giltigt. Det giltiga intervallet är mellan [0, 1].
Felaktig begäran (400) BadArgument Längden på faceIds är inte inom ett giltigt intervall. Det giltiga intervallet är mellan [1, 10].
Felaktig begäran (400) FaceNotFound Det går inte att hitta ansiktet.
Felaktig begäran (400) PersonGroupNotFound Det går inte att hitta persongruppen.
Felaktig begäran (400) LargePersonGroupNotFound Det går inte att hitta en stor persongrupp.
Felaktig begäran (400) DynamicPersonGroupNotFound Det går inte att hitta gruppen Dynamisk person.
Felaktig begäran (400) PersonGroupNotTrained Persongruppen har inte tränats.
Felaktig begäran (400) LargePersonGroupNotTrained Stor persongrupp har inte tränats.
Felaktig begäran (400) PersonGroupIdAndLargePersonGroupIdBothNotNull Grupp-ID för stora personer och grupp-ID för personer är båda inte null.
Felaktig begäran (400) PersonGroupIdAndLargePersonGroupIdBothNull Grupp-ID för stora personer och grupp-ID för personer är båda null.
Felaktig begäran (400) MissingIdentificationScopeParameters Det finns ingen parameter för identifieringsomfång i begäran.
Felaktig begäran (400) IncompatibleIdentificationScopeParametersCombination Inkompatibla parametrar för identifieringsomfång finns i begäran.
Konflikt (409) PersonGroupTrainingNotFinished Persongruppen är under utbildning.
Konflikt (409) LargePersonGroupTrainingNotFinished Stor persongrupp är under träning.

Felkoder för ansiktskontroll

Dessa felkoder kan returneras av åtgärden Ansiktskontroll.

Http-statuskod Felkod Felmeddelande beskrivning
Felaktig begäran (400) BadArgument "recognitionModel" är inkompatibel.
Felaktig begäran (400) BadArgument Ansikts-ID är ogiltigt. Ett giltigt faceId kommer från Face – Detect.
Felaktig begäran (400) BadArgument Person-ID är ogiltigt. Ett giltigt personId genereras från Skapa persongruppsperson, Skapa gruppperson för stor person eller personkatalog – Skapa person.
Felaktig begäran (400) BadArgument Persongrupp-ID är ogiltigt.
Felaktig begäran (400) BadArgument Grupp-ID för stora personer är ogiltigt.
Felaktig begäran (400) PersonNotFound Det går inte att hitta personen.
Felaktig begäran (400) PersonGroupNotFound Det går inte att hitta persongruppen.
Felaktig begäran (400) LargePersonGroupNotFound Det går inte att hitta den stora persongruppen.
Hittades inte (404) FaceNotFound Det går inte att hitta ansiktet.
Hittades inte (404) PersonNotFound Det går inte att hitta personen.
Hittades inte (404) PersistedFaceNotFound Det går inte att hitta personens beständiga ansikte.

Hitta liknande felkoder

Dessa felkoder kan returneras av liknande åtgärd för ansiktssökning.

Http-statuskod Felkod Felmeddelande beskrivning
Felaktig begäran (400) BadArgument "recognitionModel" är inkompatibel.
Felaktig begäran (400) BadArgument Läget är ogiltigt.
Felaktig begäran (400) BadArgument Ansiktslistans ID är ogiltigt.
Felaktig begäran (400) BadArgument Stort ansiktslist-ID är ogiltigt.
Felaktig begäran (400) BadArgument LargeFaceListId, faceListId och faceIds, inte exakt en av dem är giltig.
Felaktig begäran (400) BadArgument LargeFaceListId, faceListId och faceIds är alla null.
Felaktig begäran (400) BadArgument 2 eller fler av largeFaceListId, faceListId och faceIds är inte null.
Felaktig begäran (400) BadArgument Argumentet maxNumOfCandidatesReturned är inte giltigt. Det giltiga intervallet är mellan [1, 1000].
Felaktig begäran (400) BadArgument Längden på faceIds är inte inom ett giltigt intervall. Det giltiga intervallet är mellan [1, 1000].
Felaktig begäran (400) FaceNotFound Det går inte att hitta ansiktet.
Felaktig begäran (400) FaceListNotFound Ansiktslistan hittades inte.
Felaktig begäran (400) LargeFaceListNotFound Det går inte att hitta en stor ansiktslista.
Felaktig begäran (400) LargeFaceListNotTrained Den stora ansiktslistan har inte tränats.
Felaktig begäran (400) FaceListNotReady Ansiktslistan är tom.
Konflikt (409) LargeFaceListTrainingNotFinished Stor ansiktslista är under träning.

Felkoder för ansiktsgrupp

Dessa felkoder kan returneras av ansiktsgruppsåtgärden.

Http-statuskod Felkod Felmeddelande beskrivning
Felaktig begäran (400) BadArgument "recognitionModel" är inkompatibel.
Felaktig begäran (400) BadArgument Längden på faceIds är inte inom ett giltigt intervall. Det giltiga intervallet är mellan [2, 1000].

Åtgärder för persongrupp

Dessa felkoder kan returneras av persongruppsåtgärder.

Felkoder för persongrupp

Http-statuskod Felkod Felmeddelande beskrivning
Felaktig begäran (400) BadArgument Persongrupp-ID är ogiltigt. Giltigt tecken är engelsk bokstav i gemener, siffror, "-" eller "_". Maximal längd är 64.
Förbjudet (403) QuotaExceeded Persongruppsnummer har nått gränsen för prenumerationsnivå.
Förbjudet (403) QuotaExceeded Personnummer har nått gränsen för persongruppsnivå.
Förbjudet (403) QuotaExceeded Personnummer nådde prenumerationsnivågräns.
Förbjudet (403) QuotaExceeded Beständigt ansiktsnummer har nått gränsen.
Hittades inte (404) PersonGroupNotFound Det går inte att hitta persongruppen.
Hittades inte (404) PersonGroupNotFound Persongrupp-ID är ogiltigt.
Hittades inte (404) PersonNotFound Det går inte att hitta personen <personId> .
Hittades inte (404) PersonNotFound Person-ID är ogiltigt.
Hittades inte (404) PersistedFaceNotFound Det går inte att hitta det bevarade ansiktet.
Hittades inte (404) PersistedFaceNotFound Det går inte att hitta det bevarade ansiktet <faceId> .
Hittades inte (404) PersistedFaceNotFound Det bevarade ansikts-ID:t är ogiltigt.
Hittades inte (404) PersonGroupNotTrained Persongruppen har inte tränats. Det här felet visas när du får träningsstatus för en grupp som aldrig har tränats.
Konflikt (409) PersonGroupExists Persongruppen finns redan.
Konflikt (409) PersonGroupTrainingNotFinished Persongruppen är under utbildning. Försök igen när träningen har slutförts.

Felkoder för stor persongrupp

Http-statuskod Felkod Felmeddelande beskrivning
Felaktig begäran (400) BadArgument Grupp-ID för stora personer är ogiltigt. Giltigt tecken är engelsk bokstav i gemener, siffror, "-" eller "_". Maximal längd är 64.
Felaktig begäran (400) BadArgument Både "name" och "userData" är tomma.
Förbjudet (403) QuotaExceeded Ett stort persongruppsnummer har nått gränsen för prenumerationsnivå.
Förbjudet (403) QuotaExceeded Personnumret har nått gränsen för en stor persongruppsnivå.
Förbjudet (403) QuotaExceeded Personnummer nådde prenumerationsnivågräns.
Förbjudet (403) QuotaExceeded Beständigt ansiktsnummer har nått gränsen.
Hittades inte (404) LargePersonGroupNotFound Det går inte att hitta en stor persongrupp.
Hittades inte (404) LargePersonGroupNotFound Grupp-ID för stora personer är ogiltigt.
Hittades inte (404) PersonNotFound Det går inte att hitta personen <personId> .
Hittades inte (404) PersonNotFound Person-ID är ogiltigt.
Hittades inte (404) PersistedFaceNotFound Det går inte att hitta det bevarade ansiktet.
Hittades inte (404) PersistedFaceNotFound Det går inte att hitta det bevarade ansiktet <faceId> .
Hittades inte (404) PersistedFaceNotFound Det bevarade ansikts-ID:t är ogiltigt.
Hittades inte (404) LargePersonGroupNotTrained Stor persongrupp har inte tränats. Det här felet visas när du får träningsstatus för en grupp som aldrig har tränats.
Konflikt (409) LargePersonGroupExists Det finns redan en stor persongrupp.
Konflikt (409) LargePersonGroupTrainingNotFinished Stor persongrupp är under träning. Försök igen när träningen har slutförts.

Åtgärder för ansiktslista

Dessa felkoder kan returneras av ansiktslisteåtgärder.

Felkoder för ansiktslista

Http-statuskod Felkod Felmeddelande beskrivning
Felaktig begäran (400) BadArgument Ansiktslistans ID är ogiltigt. Giltigt tecken är engelsk bokstav i gemener, siffror, "-" eller "_". Maximal längd är 64.
Förbjudet (403) QuotaExceeded Beständigt ansiktsnummer har nått gränsen.
Hittades inte (404) FaceListNotFound Ansiktslistan hittades inte.
Hittades inte (404) FaceListNotFound Ansiktslistans ID är ogiltigt.
Hittades inte (404) PersistedFaceNotFound Det går inte att hitta det bevarade ansiktet.
Hittades inte (404) PersistedFaceNotFound Det bevarade ansikts-ID:t är ogiltigt.
Konflikt (409) FaceListExists Ansiktslistan finns redan.

Felkoder för stor ansiktslista

Http-statuskod Felkod Felmeddelande beskrivning
Felaktig begäran (400) BadArgument Stort ansiktslist-ID är ogiltigt. Giltigt tecken är engelsk bokstav i gemener, siffror, "-" eller "_". Maximal längd är 64.
Felaktig begäran (400) BadArgument Både "name" och "userData" är tomma.
Förbjudet (403) QuotaExceeded Stort antal ansiktslistor har nått gränsen.
Förbjudet (403) QuotaExceeded Beständigt ansiktsnummer har nått gränsen.
Hittades inte (404) LargeFaceListNotFound Det går inte att hitta en stor ansiktslista.
Hittades inte (404) LargeFaceListNotFound Stort ansiktslist-ID är ogiltigt.
Hittades inte (404) PersistedFaceNotFound Det går inte att hitta en stor ansiktslista <faceId> .
Hittades inte (404) PersistedFaceNotFound Det bevarade ansikts-ID:t är ogiltigt.
Hittades inte (404) LargeFaceListNotTrained Stor ansiktslista har inte tränats. Det här felet visas när du får träningsstatus för en stor ansiktslista som aldrig har tränats.
Konflikt (409) LargeFaceListExists Det finns redan en stor ansiktslista.
Konflikt (409) LargeFaceListTrainingNotFinished Stor ansiktslista är under träning. Försök igen när träningen har slutförts.

Person Directory-åtgärder

Dessa felkoder kan returneras av Person Directory-åtgärder.

Personkatalogens felkoder

Http-statuskod Felkod Felmeddelande beskrivning
Felaktig begäran (400) BadArgument Igenkänningsmodellen stöds inte för den här funktionen.
Felaktig begäran (400) BadArgument "start" är inte giltigt person-ID.
Felaktig begäran (400) BadArgument Både "name" och "userData" är tomma.
Felaktig begäran (400) DynamicPersonGroupNotFound Grupp-ID för dynamisk person är ogiltigt.
Förbjudet (403) QuotaExceeded Personnummer nådde prenumerationsnivågräns.
Förbjudet (403) QuotaExceeded Beständigt ansiktsnummer har nått gränsen.
Hittades inte (404) DynamicPersonGroupNotFound Det gick inte att hitta gruppen Dynamisk person.
Hittades inte (404) DynamicPersonGroupNotFound DynamicPersonGroupPersonReference <groupId> hittades inte.
Hittades inte (404) PersonNotFound Det går inte att hitta personen.
Hittades inte (404) PersonNotFound Person-ID är ogiltigt.
Hittades inte (404) PersistedFaceNotFound Det går inte att hitta det bevarade ansiktet.
Hittades inte (404) PersistedFaceNotFound Det går inte att hitta det bevarade ansiktet <faceId> .
Hittades inte (404) PersistedFaceNotFound Det bevarade ansikts-ID:t är ogiltigt.
Konflikt (409) DynamicPersonGroupExists Grupp-ID <groupId> för dynamisk person finns redan.

Nästa steg