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