Udostępnij przez

Kody błędów interfejsu API rozpoznawania twarzy usługi Azure AI

Typowe kody błędów

Te kody błędów mogą być zwracane przez dowolne wywołania interfejsu API rozpoznawania twarzy.

Kod stanu HTTP Kod błędu Komunikat o błędzie opis
Nieprawidłowe żądanie (400) BadArgument Treść żądania jest nieprawidłowa.
Nieprawidłowe żądanie (400) BadArgument Błąd analizowania kodu JSON. Nieprawidłowa lub nierozpoznawalna treść żądania JSON.
Nieprawidłowe żądanie (400) BadArgument Element „recognitionModel” jest nieprawidłowy.
Nieprawidłowe żądanie (400) BadArgument Element „detectionModel” jest nieprawidłowy.
Nieprawidłowe żądanie (400) BadArgument Wartość "name" jest pusta.
Nieprawidłowe żądanie (400) BadArgument "name" jest za długa.
Nieprawidłowe żądanie (400) BadArgument Wartość "userData" jest za długa.
Nieprawidłowe żądanie (400) BadArgument "start" jest za długi.
Nieprawidłowe żądanie (400) BadArgument Wartość "top" jest nieprawidłowa.
Nieprawidłowe żądanie (400) BadArgument Argument targetFace poza zakresem.
Nieprawidłowe żądanie (400) BadArgument Nieprawidłowy argument targetFace. Spowodowane nieprawidłowym formatem ciągu lub nieprawidłową wartością lewej/górnej/wysokości/szerokości.
Nieprawidłowe żądanie (400) InvalidURL Nieprawidłowy adres URL obrazu. Obsługiwane formaty to JPEG, PNG, GIF (pierwsza ramka) i BMP.
Nieprawidłowe żądanie (400) InvalidURL Nieprawidłowy adres URL obrazu lub błąd podczas pobierania z serwera docelowego. Zwrócony błąd serwera zdalnego: "Wystąpił błąd podczas wysyłania żądania".
Nieprawidłowe żądanie (400) InvalidImage Błąd dekodowania, nieobsługiwany format obrazu.
Nieprawidłowe żądanie (400) InvalidImage Na obrazie nie wykryto twarzy.
Nieprawidłowe żądanie (400) InvalidImage Na obrazie znajduje się więcej niż 1 twarz.
Nieprawidłowe żądanie (400) InvalidImageSize Rozmiar obrazu jest za mały. Prawidłowy rozmiar pliku obrazu powinien być większy lub równy 1 KB.
Nieprawidłowe żądanie (400) InvalidImageSize Rozmiar obrazu jest za duży. Prawidłowy rozmiar pliku obrazu nie powinien być większy niż 6 MB.
401 Brak autoryzacji 401 Odmowa dostępu z powodu nieprawidłowego klucza subskrypcji lub nieprawidłowego punktu końcowego interfejsu API. Upewnij się, że podaj prawidłowy klucz dla aktywnej subskrypcji i użyj poprawnego regionalnego punktu końcowego interfejsu API dla zasobu.
Zabronione (403) UnsupportedFeature Funkcja nie jest obsługiwana, brakuje zatwierdzenia dla co najmniej jednej z następujących funkcji: Identyfikacja, Weryfikacja. Zarejestruj się, aby uzyskać dostęp, przesyłając formularz rejestracji.
Konflikt (409) ConcurrentOperationConflict Wystąpił konflikt operacji na zasobie <resourceName>. Spróbuj później.
Zbyt wiele żądań (429) 429 Przekroczono limit szybkości.

Kody błędów wykrywania twarzy

Te kody błędów mogą być zwracane przez operację wykrywania twarzy.

Kod stanu HTTP Kod błędu Komunikat o błędzie opis
Nieprawidłowe żądanie (400) BadArgument Nieprawidłowy argument returnFaceAttributes.
Nieprawidłowe żądanie (400) BadArgument Funkcja „returnFaceAttributes” nie jest obsługiwana przez detection_02.
Nieprawidłowe żądanie (400) BadArgument Znaki „returnLandmarks” nie są obsługiwane przez detection_02.
Zabronione (403) UnsupportedFeature Atrybuty powrotu (emocje, płeć, wiek, uśmiech, zarost, włosy i makijaż) zostały przestarzałe i nie są już obsługiwane. Wyślij wiadomość e-mail do zespołu ds. rozpoznawania twarzy platformy Azure, jeśli masz odpowiedzialny przypadek użycia, który będzie korzystać z dowolnej z ograniczonych możliwości.

Kody błędów sesji liveness rozpoznawania twarzy

Te kody błędów mogą być zwracane przez operacje sesji liveness rozpoznawania twarzy.

Kod stanu HTTP Kod błędu Komunikat o błędzie opis
Nieprawidłowe żądanie (400) BadArgument Parametr początkowy jest nieprawidłowy. Określ pole "Id" ostatniego wpisu, aby kontynuować proces wyświetlania listy.
Nieprawidłowe żądanie (400) BadArgument Górny parametr jest nieprawidłowy. Prawidłowy zakres wynosi od 1 do 1000 włącznie.
Nieprawidłowe żądanie (400) InvalidRequestBody Podano niepoprawną treść żądania. Sprawdź schemat operacji i spróbuj ponownie.
Nieprawidłowe żądanie (400) InvalidTokenLifetime Określono nieprawidłowe authTokenTimeToLiveInSeconds. Musi należeć do zakresu od 60 do 86400.
Nieprawidłowe żądanie (400) InvalidLivenessOperationMode Określono nieprawidłowy tryb livenessOperationMode. Musi być "pasywny".
Nieprawidłowe żądanie (400) InvalidDeviceCorrelationId Identyfikator korelacji urządzenia jest wymagany w treści żądania podczas tworzenia sesji lub uruchamiania sesji. Nie może mieć wartości null ani być pusta i nie może zawierać więcej niż 64 znaków.
Nie znaleziono (404) SessionNotFound Nie można odnaleźć identyfikatora sesji. Identyfikator sesji wygasł lub nie istnieje.

Kody błędów rozpoznawania twarzy

Te kody błędów mogą być zwracane przez operację Rozpoznawanie twarzy.

Kod stanu HTTP Kod błędu Komunikat o błędzie opis
Nieprawidłowe żądanie (400) BadArgument Element "recognitionModel" jest niezgodny.
Nieprawidłowe żądanie (400) BadArgument Identyfikator grupy osób jest nieprawidłowy.
Nieprawidłowe żądanie (400) BadArgument Identyfikator grupy dużej osoby jest nieprawidłowy.
Nieprawidłowe żądanie (400) BadArgument Identyfikator grupy osób dynamicznych jest nieprawidłowy.
Nieprawidłowe żądanie (400) BadArgument Argument maxNumOfCandidatesReturned jest nieprawidłowy. Prawidłowy zakres wynosi od [1, 100].
Nieprawidłowe żądanie (400) BadArgument Argument confidenceThreshold jest nieprawidłowy. Prawidłowy zakres wynosi od [0, 1].
Nieprawidłowe żądanie (400) BadArgument Długość identyfikatorów faceId nie znajduje się w prawidłowym zakresie. Prawidłowy zakres wynosi od [1, 10].
Nieprawidłowe żądanie (400) FaceNotFound Nie można odnaleźć twarzy.
Nieprawidłowe żądanie (400) PersonGroupNotFound Nie można odnaleźć grupy osób.
Nieprawidłowe żądanie (400) LargePersonGroupNotFound Nie można odnaleźć grupy osób.
Nieprawidłowe żądanie (400) DynamicPersonGroupNotFound Nie można odnaleźć grupy osób dynamicznych.
Nieprawidłowe żądanie (400) PersonGroupNotTrained Grupa osób nie jest wytrenowana.
Nieprawidłowe żądanie (400) LargePersonGroupNotTrained Grupa dużych osób nie jest wytrenowana.
Nieprawidłowe żądanie (400) PersonGroupIdAndLargePersonGroupIdBothNotNull Identyfikator grupy dużej osoby i identyfikator grupy osób nie mają wartości null.
Nieprawidłowe żądanie (400) PersonGroupIdAndLargePersonGroupIdBothNull Identyfikator grupy dużej osoby i identyfikator grupy osób mają wartość null.
Nieprawidłowe żądanie (400) MissingIdentificationScopeParameters W żądaniu nie ma parametru zakresu identyfikacji.
Nieprawidłowe żądanie (400) NiezgodnaIdentificationScopeParametersCombination Niezgodne parametry zakresu identyfikacji znajdują się w żądaniu.
Konflikt (409) PersonGroupTrainingNotFinished Grupa osób jest szkolona.
Konflikt (409) LargePersonGroupTrainingNotFinished Duża grupa osób jest szkolona.

Kody błędów weryfikacji twarzy

Te kody błędów mogą być zwracane przez operację Weryfikowanie twarzy.

Kod stanu HTTP Kod błędu Komunikat o błędzie opis
Nieprawidłowe żądanie (400) BadArgument Element "recognitionModel" jest niezgodny.
Nieprawidłowe żądanie (400) BadArgument Identyfikator twarzy jest nieprawidłowy. Prawidłowy identyfikator faceId pochodzi z face - Detect.
Nieprawidłowe żądanie (400) BadArgument Identyfikator osoby jest nieprawidłowy. Prawidłowy identyfikator personId jest generowany na podstawie polecenia Create Person Group Person Person, Create Large Person Group Person Or Person Directory — Create Person (Tworzenie osoby lub katalogu osób).
Nieprawidłowe żądanie (400) BadArgument Identyfikator grupy osób jest nieprawidłowy.
Nieprawidłowe żądanie (400) BadArgument Identyfikator grupy dużej osoby jest nieprawidłowy.
Nieprawidłowe żądanie (400) PersonNotFound Nie można odnaleźć osoby.
Nieprawidłowe żądanie (400) PersonGroupNotFound Nie można odnaleźć grupy osób.
Nieprawidłowe żądanie (400) LargePersonGroupNotFound Nie można odnaleźć grupy osób.
Nie znaleziono (404) FaceNotFound Nie można odnaleźć twarzy.
Nie znaleziono (404) PersonNotFound Nie można odnaleźć osoby.
Nie znaleziono (404) PersistedFaceNotFound Nie znaleziono utrwalonej twarzy osoby.

Znajdowanie podobnych kodów błędów

Te kody błędów mogą być zwracane przez operację Wyszukiwanie podobnych twarzy.

Kod stanu HTTP Kod błędu Komunikat o błędzie opis
Nieprawidłowe żądanie (400) BadArgument Element "recognitionModel" jest niezgodny.
Nieprawidłowe żądanie (400) BadArgument Tryb jest nieprawidłowy.
Nieprawidłowe żądanie (400) BadArgument Identyfikator listy twarzy jest nieprawidłowy.
Nieprawidłowe żądanie (400) BadArgument Duży identyfikator listy twarzy jest nieprawidłowy.
Nieprawidłowe żądanie (400) BadArgument LargeFaceListId, faceListId i faceIds, a nie dokładnie jeden z nich jest prawidłowy.
Nieprawidłowe żądanie (400) BadArgument LargeFaceListId, faceListId i faceId mają wartość null.
Nieprawidłowe żądanie (400) BadArgument 2 lub więcej dużych identyfikatorówFaceListId, faceListId i faceId nie mają wartości null.
Nieprawidłowe żądanie (400) BadArgument Argument maxNumOfCandidatesReturned jest nieprawidłowy. Prawidłowy zakres wynosi od [1, 1000].
Nieprawidłowe żądanie (400) BadArgument Długość identyfikatorów faceId nie znajduje się w prawidłowym zakresie. Prawidłowy zakres wynosi od [1, 1000].
Nieprawidłowe żądanie (400) FaceNotFound Nie można odnaleźć twarzy.
Nieprawidłowe żądanie (400) FaceListNotFound Nie można odnaleźć listy twarzy.
Nieprawidłowe żądanie (400) LargeFaceListNotFound Nie można odnaleźć dużej listy twarzy.
Nieprawidłowe żądanie (400) LargeFaceListNotTrained Duża lista twarzy nie jest wytrenowana.
Nieprawidłowe żądanie (400) FaceListNotReady Lista twarzy jest pusta.
Konflikt (409) LargeFaceListTrainingNotFinished Duża lista twarzy jest pod szkoleniem.

Kody błędów grupy rozpoznawania twarzy

Te kody błędów można zwrócić za pomocą operacji grupy twarzy.

Kod stanu HTTP Kod błędu Komunikat o błędzie opis
Nieprawidłowe żądanie (400) BadArgument Element "recognitionModel" jest niezgodny.
Nieprawidłowe żądanie (400) BadArgument Długość identyfikatorów faceId nie znajduje się w prawidłowym zakresie. Prawidłowy zakres wynosi od [2, 1000].

Operacje grupy osób

Te kody błędów mogą być zwracane przez operacje grupy osób.

Kody błędów grupy osób

Kod stanu HTTP Kod błędu Komunikat o błędzie opis
Nieprawidłowe żądanie (400) BadArgument Identyfikator grupy osób jest nieprawidłowy. Prawidłowy znak to litera angielska w małej litery, cyfra, "-" lub "_". Maksymalna długość to 64.
Zabronione (403) QuotaExceeded Numer grupy osób osiągnął limit poziomu subskrypcji.
Zabronione (403) QuotaExceeded Liczba osób osiągnęła limit poziomu grupy osób.
Zabronione (403) QuotaExceeded Numer osoby osiągnął limit poziomu subskrypcji.
Zabronione (403) QuotaExceeded Utrwalone liczby twarzy osiągnęły limit.
Nie znaleziono (404) PersonGroupNotFound Nie można odnaleźć grupy osób.
Nie znaleziono (404) PersonGroupNotFound Identyfikator grupy osób jest nieprawidłowy.
Nie znaleziono (404) PersonNotFound Nie można odnaleźć osoby <personId> .
Nie znaleziono (404) PersonNotFound Identyfikator osoby jest nieprawidłowy.
Nie znaleziono (404) PersistedFaceNotFound Nie można odnaleźć utrwalonej twarzy.
Nie znaleziono (404) PersistedFaceNotFound Nie można odnaleźć utrwalonej twarzy <faceId> .
Nie znaleziono (404) PersistedFaceNotFound Utrwalone identyfikatory twarzy są nieprawidłowe.
Nie znaleziono (404) PersonGroupNotTrained Grupa osób nie jest wytrenowana. Ten błąd pojawia się podczas uzyskiwania stanu szkolenia grupy, która nigdy nie została wytrenowana.
Konflikt (409) PersonGroupExists Grupa osób już istnieje.
Konflikt (409) PersonGroupTrainingNotFinished Grupa osób jest szkolona. Spróbuj ponownie po zakończeniu trenowania.

Kody błędów grupy dużych osób

Kod stanu HTTP Kod błędu Komunikat o błędzie opis
Nieprawidłowe żądanie (400) BadArgument Identyfikator grupy dużej osoby jest nieprawidłowy. Prawidłowy znak to litera angielska w małej litery, cyfra, "-" lub "_". Maksymalna długość to 64.
Nieprawidłowe żądanie (400) BadArgument Obie wartości "name" i "userData" są puste.
Zabronione (403) QuotaExceeded Liczba dużej grupy osób osiągnęła limit poziomu subskrypcji.
Zabronione (403) QuotaExceeded Liczba osób osiągnęła limit na poziomie grupy dużej osoby.
Zabronione (403) QuotaExceeded Numer osoby osiągnął limit poziomu subskrypcji.
Zabronione (403) QuotaExceeded Utrwalone liczby twarzy osiągnęły limit.
Nie znaleziono (404) LargePersonGroupNotFound Nie można odnaleźć grupy osób.
Nie znaleziono (404) LargePersonGroupNotFound Identyfikator grupy dużej osoby jest nieprawidłowy.
Nie znaleziono (404) PersonNotFound Nie można odnaleźć osoby <personId> .
Nie znaleziono (404) PersonNotFound Identyfikator osoby jest nieprawidłowy.
Nie znaleziono (404) PersistedFaceNotFound Nie można odnaleźć utrwalonej twarzy.
Nie znaleziono (404) PersistedFaceNotFound Nie można odnaleźć utrwalonej twarzy <faceId> .
Nie znaleziono (404) PersistedFaceNotFound Utrwalone identyfikatory twarzy są nieprawidłowe.
Nie znaleziono (404) LargePersonGroupNotTrained Grupa dużych osób nie jest wytrenowana. Ten błąd pojawia się podczas uzyskiwania stanu szkolenia grupy, która nigdy nie została wytrenowana.
Konflikt (409) LargePersonGroupExists Duża grupa osób już istnieje.
Konflikt (409) LargePersonGroupTrainingNotFinished Duża grupa osób jest szkolona. Spróbuj ponownie po zakończeniu trenowania.

Operacje na liście twarzy

Te kody błędów mogą być zwracane przez operacje listy twarzy.

Kody błędów listy twarzy

Kod stanu HTTP Kod błędu Komunikat o błędzie opis
Nieprawidłowe żądanie (400) BadArgument Identyfikator listy twarzy jest nieprawidłowy. Prawidłowy znak to litera angielska w małej litery, cyfra, "-" lub "_". Maksymalna długość to 64.
Zabronione (403) QuotaExceeded Utrwalone liczby twarzy osiągnęły limit.
Nie znaleziono (404) FaceListNotFound Nie można odnaleźć listy twarzy.
Nie znaleziono (404) FaceListNotFound Identyfikator listy twarzy jest nieprawidłowy.
Nie znaleziono (404) PersistedFaceNotFound Nie można odnaleźć utrwalonej twarzy.
Nie znaleziono (404) PersistedFaceNotFound Utrwalone identyfikatory twarzy są nieprawidłowe.
Konflikt (409) FaceListExists Lista twarzy już istnieje.

Kody błędów dużej listy twarzy

Kod stanu HTTP Kod błędu Komunikat o błędzie opis
Nieprawidłowe żądanie (400) BadArgument Duży identyfikator listy twarzy jest nieprawidłowy. Prawidłowy znak to litera angielska w małej litery, cyfra, "-" lub "_". Maksymalna długość to 64.
Nieprawidłowe żądanie (400) BadArgument Obie wartości "name" i "userData" są puste.
Zabronione (403) QuotaExceeded Osiągnięto limit dużej liczby list twarzy.
Zabronione (403) QuotaExceeded Utrwalone liczby twarzy osiągnęły limit.
Nie znaleziono (404) LargeFaceListNotFound Nie można odnaleźć dużej listy twarzy.
Nie znaleziono (404) LargeFaceListNotFound Duży identyfikator listy twarzy jest nieprawidłowy.
Nie znaleziono (404) PersistedFaceNotFound Nie można odnaleźć dużej twarzy <faceId> na liście twarzy.
Nie znaleziono (404) PersistedFaceNotFound Utrwalone identyfikatory twarzy są nieprawidłowe.
Nie znaleziono (404) LargeFaceListNotTrained Duża lista twarzy nie jest wytrenowana. Ten błąd pojawia się podczas uzyskiwania stanu trenowania dużej listy twarzy, która nigdy nie została wytrenowana.
Konflikt (409) LargeFaceListExists Duża lista twarzy już istnieje.
Konflikt (409) LargeFaceListTrainingNotFinished Duża lista twarzy jest pod szkoleniem. Spróbuj ponownie po zakończeniu trenowania.

Operacje katalogu osób

Te kody błędów mogą być zwracane przez operacje katalogu osób.

Kody błędów katalogu osób

Kod stanu HTTP Kod błędu Komunikat o błędzie opis
Nieprawidłowe żądanie (400) BadArgument Model rozpoznawania nie jest obsługiwany w przypadku tej funkcji.
Nieprawidłowe żądanie (400) BadArgument Identyfikator "start" nie jest prawidłowym identyfikatorem osoby.
Nieprawidłowe żądanie (400) BadArgument Obie wartości "name" i "userData" są puste.
Nieprawidłowe żądanie (400) DynamicPersonGroupNotFound Identyfikator grupy osób dynamicznych jest nieprawidłowy.
Zabronione (403) QuotaExceeded Numer osoby osiągnął limit poziomu subskrypcji.
Zabronione (403) QuotaExceeded Utrwalone liczby twarzy osiągnęły limit.
Nie znaleziono (404) DynamicPersonGroupNotFound Nie można odnaleźć dynamicznej grupy osób.
Nie znaleziono (404) DynamicPersonGroupNotFound Nie można odnaleźć obiektu DynamicPersonGroupPersonReference <groupId> .
Nie znaleziono (404) PersonNotFound Nie można odnaleźć osoby.
Nie znaleziono (404) PersonNotFound Identyfikator osoby jest nieprawidłowy.
Nie znaleziono (404) PersistedFaceNotFound Nie można odnaleźć utrwalonej twarzy.
Nie znaleziono (404) PersistedFaceNotFound Nie można odnaleźć utrwalonej twarzy <faceId> .
Nie znaleziono (404) PersistedFaceNotFound Utrwalone identyfikatory face ID są nieprawidłowe.
Konflikt (409) DynamicPersonGroupExists Identyfikator <groupId> grupy osób dynamicznych już istnieje.

Następne kroki

  • Last updated on