다음을 통해 공유

Azure AI Face API 오류 코드

  • 아티클

일반적인 오류 코드

이러한 오류 코드는 Face API 호출에서 반환할 수 있습니다.

Http 상태 코드 오류 코드 오류 메시지 설명
잘못된 요청(400) BadArgument 요청 본문이 잘못되었습니다.
잘못된 요청(400) BadArgument JSON 구문 분석 오류입니다. 잘못되거나 인식할 수 없는 요청 JSON 본문입니다.
잘못된 요청(400) BadArgument 'recognitionModel'이 잘못되었습니다.
잘못된 요청(400) BadArgument 'detectionModel'이 잘못되었습니다.
잘못된 요청(400) BadArgument 'name'이 비어 있습니다.
잘못된 요청(400) BadArgument 'name'이 너무 깁니다.
잘못된 요청(400) BadArgument 'userData'가 너무 깁니다.
잘못된 요청(400) BadArgument 'start'가 너무 깁니다.
잘못된 요청(400) BadArgument 'top'이(가) 잘못되었습니다.
잘못된 요청(400) BadArgument 인수 targetFace가 범위를 벗어났습니다.
잘못된 요청(400) BadArgument 인수 targetFace가 잘못되었습니다. 잘못된 문자열 형식 또는 잘못된 왼쪽/위쪽/높이/너비 값으로 인해 발생합니다.
잘못된 요청(400) InvalidURL 잘못된 이미지 URL입니다. 지원되는 형식은 JPEG, PNG, GIF(첫 번째 프레임), BMP를 포함합니다.
잘못된 요청(400) InvalidURL 이미지 URL이 잘못되었거나 대상 서버에서 다운로드하는 동안 오류가 발생했습니다. 원격 서버 오류가 반환되었습니다. "요청을 보내는 동안 오류가 발생했습니다."
잘못된 요청(400) InvalidImage 디코딩 오류, 이미지 형식이 지원되지 않습니다.
잘못된 요청(400) InvalidImage 이미지에서 얼굴을 감지하지 못했습니다.
잘못된 요청(400) InvalidImage 이미지에 얼굴이 1개 이상 있습니다.
잘못된 요청(400) InvalidImageSize 이미지 크기가 너무 작습니다. 유효한 이미지 파일 크기는 1KB보다 크거나 같아야 합니다.
잘못된 요청(400) InvalidImageSize 이미지 크기가 너무 큽니다. 유효한 이미지 파일 크기는 6MB 이하여야 합니다.
권한 없음(401) 401 잘못된 구독 키 또는 잘못된 API 엔드포인트로 인해 액세스가 거부되었습니다. 활성 구독에 유효한 키를 제공하고 리소스에 올바른 지역 API 엔드포인트를 사용해야 합니다.
사용할 수 없음(403) UnsupportedFeature 기능은 지원되지 않으며 ID, 확인 기능 중 하나 이상에 대한 승인이 없습니다. 등록 양식을 제출하여 액세스에 등록합니다.
충돌(409) ConcurrentOperationConflict 리소스 <resourceName>에 충돌 작업이 있습니다. 나중에 시도해 보세요.
요청이 너무 많음(429) 429 속도 제한을 초과했습니다.

얼굴 감지 오류 코드

이러한 오류 코드는 얼굴 감지 작업에서 반환할 수 있습니다.

Http 상태 코드 오류 코드 오류 메시지 설명
잘못된 요청(400) BadArgument 잘못된 인수 returnFaceAttributes입니다.
잘못된 요청(400) BadArgument 'returnFaceAttributes'는 detection_02에서 지원되지 않습니다.
잘못된 요청(400) BadArgument 'returnLandmarks'는 detection_02에서 지원되지 않습니다.
사용할 수 없음(403) UnsupportedFeature 반환 특성(감정, 성별, 나이, 미소, 얼굴 털, 머리카락 및 메이크업)은 더 이상 사용되지 않으며 더 이상 지원되지 않습니다. 제한된 기능을 사용하는 데 도움이 되는 책임 있는 사용 사례가 있는 경우 Azure Face 팀에 이메일을 보냅니다.

Face Liveness 세션 오류 코드

이러한 오류 코드는 Face Liveness 세션 작업에서 반환할 수 있습니다.

Http 상태 코드 오류 코드 오류 메시지 설명
잘못된 요청(400) BadArgument 시작 매개 변수가 잘못되었습니다. 목록 프로세스를 계속하려면 마지막 항목의 'ID' 필드를 지정하세요.
잘못된 요청(400) BadArgument Top 매개 변수가 잘못되었습니다. 유효한 범위는 1에서 1000 사이입니다.
잘못된 요청(400) InvalidRequestBody 잘못된 요청 본문이 제공되었습니다. 작업 스키마를 확인하고 다시 시도하세요.
잘못된 요청(400) InvalidTokenLifetime 잘못된 authTokenTimeToLiveInSeconds가 지정되었습니다. 60~86400 이내여야 합니다.
잘못된 요청(400) InvalidLivenessOperationMode 잘못된 livenessOperationMode가 지정되었습니다. '수동'이어야 합니다.
잘못된 요청(400) InvalidDeviceCorrelationId 세션 만들기 또는 세션 시작 중에 요청 본문에 디바이스 상관 관계 ID가 필요합니다. null이거나 비어 있지 않아야 하며 64자를 넘지 않아야 합니다.
찾을 수 없음(404) SessionNotFound 세션 ID를 찾을 수 없습니다. 세션 ID가 만료되었거나 존재하지 않습니다.

Face Identify 오류 코드

이러한 오류 코드는 Face Identify 작업에서 반환할 수 있습니다.

Http 상태 코드 오류 코드 오류 메시지 설명
잘못된 요청(400) BadArgument 'recognitionModel'은 호환되지 않습니다.
잘못된 요청(400) BadArgument 개인 그룹 ID가 잘못되었습니다.
잘못된 요청(400) BadArgument 큰 사용자 그룹 ID가 잘못되었습니다.
잘못된 요청(400) BadArgument 동적 사용자 그룹 ID가 잘못되었습니다.
잘못된 요청(400) BadArgument maxNumOfCandidatesReturned 인수가 잘못되었습니다. 유효한 범위는 [1, 100] 사이입니다.
잘못된 요청(400) BadArgument confidenceThreshold 인수가 잘못되었습니다. 유효한 범위는 [0, 1] 사이입니다.
잘못된 요청(400) BadArgument faceId의 길이가 유효한 범위에 있지 않습니다. 유효한 범위는 [1, 10] 사이입니다.
잘못된 요청(400) FaceNotFound 얼굴을 찾을 수 없습니다.
잘못된 요청(400) PersonGroupNotFound 개인 그룹을 찾을 수 없습니다.
잘못된 요청(400) LargePersonGroupNotFound 큰 사람 그룹을 찾을 수 없습니다.
잘못된 요청(400) DynamicPersonGroupNotFound 동적 인물 그룹을 찾을 수 없습니다.
잘못된 요청(400) PersonGroupNotTrained 학습되지 않은 개인 그룹입니다.
잘못된 요청(400) LargePersonGroupNotTrained 대규모 사용자 그룹이 학습되지 않았습니다.
잘못된 요청(400) PersonGroupIdAndLargePersonGroupIdBothNotNull 큰 사람 그룹 ID와 개인 그룹 ID는 모두 null이 아닙니다.
잘못된 요청(400) PersonGroupIdAndLargePersonGroupIdBothNull 큰 사람 그룹 ID와 개인 그룹 ID는 모두 null입니다.
잘못된 요청(400) MissingIdentificationScopeParameters 요청에 식별 범위 매개 변수가 없습니다.
잘못된 요청(400) IncompatibleIdentificationScopeParametersCombination 호환되지 않는 식별 범위 매개 변수가 요청에 있습니다.
충돌(409) PersonGroupTrainingNotFinished 개인 그룹이 학습 중입니다.
충돌(409) LargePersonGroupTrainingNotFinished 대규모 개인 그룹이 학습 중입니다.

Face Verify 오류 코드

이러한 오류 코드는 Face Verify 작업에서 반환할 수 있습니다.

Http 상태 코드 오류 코드 오류 메시지 설명
잘못된 요청(400) BadArgument 'recognitionModel'은 호환되지 않습니다.
잘못된 요청(400) BadArgument 얼굴 ID가 잘못되었습니다. 유효한 faceId는 Face - Detect에서 제공됩니다.
잘못된 요청(400) BadArgument 개인 ID가 잘못되었습니다. 유효한 personId는 사람 그룹 사람 만들기, 큰 사람 그룹 사용자 만들기 또는 사람 디렉터리 - 사람 만들기에서 생성됩니다.
잘못된 요청(400) BadArgument 개인 그룹 ID가 잘못되었습니다.
잘못된 요청(400) BadArgument 큰 사용자 그룹 ID가 잘못되었습니다.
잘못된 요청(400) PersonNotFound 사람을 찾을 수 없습니다.
잘못된 요청(400) PersonGroupNotFound 개인 그룹을 찾을 수 없습니다.
잘못된 요청(400) LargePersonGroupNotFound 큰 사람 그룹을 찾을 수 없습니다.
찾을 수 없음(404) FaceNotFound 얼굴을 찾을 수 없습니다.
찾을 수 없음(404) PersonNotFound 사람을 찾을 수 없습니다.
찾을 수 없음(404) PersistedFaceNotFound 사람의 지속형 얼굴을 찾을 수 없습니다.

유사한 오류 코드 찾기

이러한 오류 코드는 Face Find Similar 작업에서 반환할 수 있습니다.

Http 상태 코드 오류 코드 오류 메시지 설명
잘못된 요청(400) BadArgument 'recognitionModel'은 호환되지 않습니다.
잘못된 요청(400) BadArgument 모드가 잘못되었습니다.
잘못된 요청(400) BadArgument 얼굴 목록 ID가 잘못되었습니다.
잘못된 요청(400) BadArgument 큰 얼굴 목록 ID가 잘못되었습니다.
잘못된 요청(400) BadArgument LargeFaceListId, faceListId 및 faceIds 중 하나만 유효하지 않습니다.
잘못된 요청(400) BadArgument LargeFaceListId, faceListId 및 faceId는 모두 null입니다.
잘못된 요청(400) BadArgument 2개 이상의 largeFaceListId, faceListId 및 faceId가 null이 아닙니다.
잘못된 요청(400) BadArgument maxNumOfCandidatesReturned 인수가 잘못되었습니다. 유효한 범위는 [1, 1000] 사이입니다.
잘못된 요청(400) BadArgument faceId의 길이가 유효한 범위에 있지 않습니다. 유효한 범위는 [1, 1000] 사이입니다.
잘못된 요청(400) FaceNotFound 얼굴을 찾을 수 없습니다.
잘못된 요청(400) FaceListNotFound 얼굴 목록을 찾을 수 없습니다.
잘못된 요청(400) LargeFaceListNotFound 큰 얼굴 목록을 찾을 수 없습니다.
잘못된 요청(400) LargeFaceListNotTrained 큰 얼굴 목록은 학습되지 않습니다.
잘못된 요청(400) FaceListNotReady 얼굴 목록이 비어 있습니다.
충돌(409) LargeFaceListTrainingNotFinished 큰 얼굴 목록이 학습 중입니다.

얼굴 그룹 오류 코드

이러한 오류 코드는 Face Group 작업에서 반환할 수 있습니다.

Http 상태 코드 오류 코드 오류 메시지 설명
잘못된 요청(400) BadArgument 'recognitionModel'은 호환되지 않습니다.
잘못된 요청(400) BadArgument faceId의 길이가 유효한 범위에 있지 않습니다. 유효한 범위는 [2, 1000] 사이입니다.

개인 그룹 작업

이러한 오류 코드는 개인 그룹 작업에서 반환할 수 있습니다.

개인 그룹 오류 코드

Http 상태 코드 오류 코드 오류 메시지 설명
잘못된 요청(400) BadArgument 개인 그룹 ID가 잘못되었습니다. 유효한 문자는 소문자, 숫자, '-' 또는 '_'의 영어 문자입니다. 최대 길이는 64입니다.
사용할 수 없음(403) QuotaExceeded 개인 그룹 번호가 구독 수준 제한에 도달했습니다.
사용할 수 없음(403) QuotaExceeded 개인 번호가 개인 그룹 수준 제한에 도달했습니다.
사용할 수 없음(403) QuotaExceeded 개인 번호가 구독 수준 제한에 도달했습니다.
사용할 수 없음(403) QuotaExceeded 지속형 얼굴 번호가 제한에 도달했습니다.
찾을 수 없음(404) PersonGroupNotFound 개인 그룹을 찾을 수 없습니다.
찾을 수 없음(404) PersonGroupNotFound 개인 그룹 ID가 잘못되었습니다.
찾을 수 없음(404) PersonNotFound 사람을 <personId> 찾을 수 없습니다.
찾을 수 없음(404) PersonNotFound 개인 ID가 잘못되었습니다.
찾을 수 없음(404) PersistedFaceNotFound 지속형 얼굴을 찾을 수 없습니다.
찾을 수 없음(404) PersistedFaceNotFound 지속형 얼굴을 <faceId> 찾을 수 없습니다.
찾을 수 없음(404) PersistedFaceNotFound 지속형 얼굴 ID가 잘못되었습니다.
찾을 수 없음(404) PersonGroupNotTrained 학습되지 않은 개인 그룹입니다. 이 오류는 학습되지 않은 그룹의 학습 상태를 가져오는 동안 나타납니다.
충돌(409) PersonGroupExists 개인 그룹이 이미 있습니다.
충돌(409) PersonGroupTrainingNotFinished 개인 그룹이 학습 중입니다. 학습이 완료된 후 다시 시도합니다.

큰 사용자 그룹 오류 코드

Http 상태 코드 오류 코드 오류 메시지 설명
잘못된 요청(400) BadArgument 큰 사용자 그룹 ID가 잘못되었습니다. 유효한 문자는 소문자, 숫자, '-' 또는 '_'의 영어 문자입니다. 최대 길이는 64입니다.
잘못된 요청(400) BadArgument 'name' 및 'userData'는 모두 비어 있습니다.
사용할 수 없음(403) QuotaExceeded 큰 사용자 그룹 번호가 구독 수준 제한에 도달했습니다.
사용할 수 없음(403) QuotaExceeded 개인 번호가 큰 사람 그룹 수준 제한에 도달했습니다.
사용할 수 없음(403) QuotaExceeded 개인 번호가 구독 수준 제한에 도달했습니다.
사용할 수 없음(403) QuotaExceeded 지속형 얼굴 번호가 제한에 도달했습니다.
찾을 수 없음(404) LargePersonGroupNotFound 큰 사람 그룹을 찾을 수 없습니다.
찾을 수 없음(404) LargePersonGroupNotFound 큰 사용자 그룹 ID가 잘못되었습니다.
찾을 수 없음(404) PersonNotFound 사람을 <personId> 찾을 수 없습니다.
찾을 수 없음(404) PersonNotFound 개인 ID가 잘못되었습니다.
찾을 수 없음(404) PersistedFaceNotFound 지속형 얼굴을 찾을 수 없습니다.
찾을 수 없음(404) PersistedFaceNotFound 지속형 얼굴을 <faceId> 찾을 수 없습니다.
찾을 수 없음(404) PersistedFaceNotFound 지속형 얼굴 ID가 잘못되었습니다.
찾을 수 없음(404) LargePersonGroupNotTrained 대규모 사용자 그룹이 학습되지 않았습니다. 이 오류는 학습되지 않은 그룹의 학습 상태를 가져오는 동안 나타납니다.
충돌(409) LargePersonGroupExists 대규모 사용자 그룹이 이미 있습니다.
충돌(409) LargePersonGroupTrainingNotFinished 대규모 개인 그룹이 학습 중입니다. 학습이 완료된 후 다시 시도합니다.

얼굴 목록 작업

이러한 오류 코드는 Face List 작업에서 반환할 수 있습니다.

Face List 오류 코드

Http 상태 코드 오류 코드 오류 메시지 설명
잘못된 요청(400) BadArgument 얼굴 목록 ID가 잘못되었습니다. 유효한 문자는 소문자, 숫자, '-' 또는 '_'의 영어 문자입니다. 최대 길이는 64입니다.
사용할 수 없음(403) QuotaExceeded 지속형 얼굴 번호가 제한에 도달했습니다.
찾을 수 없음(404) FaceListNotFound 얼굴 목록을 찾을 수 없습니다.
찾을 수 없음(404) FaceListNotFound 얼굴 목록 ID가 잘못되었습니다.
찾을 수 없음(404) PersistedFaceNotFound 지속형 얼굴을 찾을 수 없습니다.
찾을 수 없음(404) PersistedFaceNotFound 지속형 얼굴 ID가 잘못되었습니다.
충돌(409) FaceListExists 얼굴 목록이 이미 있습니다.

큰 얼굴 목록 오류 코드

Http 상태 코드 오류 코드 오류 메시지 설명
잘못된 요청(400) BadArgument 큰 얼굴 목록 ID가 잘못되었습니다. 유효한 문자는 소문자, 숫자, '-' 또는 '_'의 영어 문자입니다. 최대 길이는 64입니다.
잘못된 요청(400) BadArgument 'name' 및 'userData'는 모두 비어 있습니다.
사용할 수 없음(403) QuotaExceeded 큰 얼굴 목록 번호가 제한에 도달했습니다.
사용할 수 없음(403) QuotaExceeded 지속형 얼굴 번호가 제한에 도달했습니다.
찾을 수 없음(404) LargeFaceListNotFound 큰 얼굴 목록을 찾을 수 없습니다.
찾을 수 없음(404) LargeFaceListNotFound 큰 얼굴 목록 ID가 잘못되었습니다.
찾을 수 없음(404) PersistedFaceNotFound 큰 얼굴 목록 얼굴을 <faceId> 찾을 수 없습니다.
찾을 수 없음(404) PersistedFaceNotFound 지속형 얼굴 ID가 잘못되었습니다.
찾을 수 없음(404) LargeFaceListNotTrained 큰 얼굴 목록이 학습되지 않았습니다. 이 오류는 학습되지 않은 큰 얼굴 목록의 학습 상태를 가져오는 동안 나타납니다.
충돌(409) LargeFaceListExists 큰 얼굴 목록이 이미 있습니다.
충돌(409) LargeFaceListTrainingNotFinished 큰 얼굴 목록이 학습 중입니다. 학습이 완료된 후 다시 시도합니다.

개인 디렉터리 작업

이러한 오류 코드는 Person Directory 작업에서 반환할 수 있습니다.

개인 디렉터리 오류 코드

Http 상태 코드 오류 코드 오류 메시지 설명
잘못된 요청(400) BadArgument 이 기능에는 인식 모델이 지원되지 않습니다.
잘못된 요청(400) BadArgument 'start'가 올바른 사람 ID가 아닙니다.
잘못된 요청(400) BadArgument 'name' 및 'userData'는 모두 비어 있습니다.
잘못된 요청(400) DynamicPersonGroupNotFound 동적 사용자 그룹 ID가 잘못되었습니다.
사용할 수 없음(403) QuotaExceeded 개인 번호가 구독 수준 제한에 도달했습니다.
사용할 수 없음(403) QuotaExceeded 지속형 얼굴 번호가 제한에 도달했습니다.
찾을 수 없음(404) DynamicPersonGroupNotFound 동적 사용자 그룹을 찾을 수 없습니다.
찾을 수 없음(404) DynamicPersonGroupNotFound DynamicPersonGroupPersonReference <groupId> 를 찾을 수 없습니다.
찾을 수 없음(404) PersonNotFound 사람을 찾을 수 없습니다.
찾을 수 없음(404) PersonNotFound 개인 ID가 잘못되었습니다.
찾을 수 없음(404) PersistedFaceNotFound 지속형 얼굴을 찾을 수 없습니다.
찾을 수 없음(404) PersistedFaceNotFound 지속형 얼굴을 <faceId> 찾을 수 없습니다.
찾을 수 없음(404) PersistedFaceNotFound 지속형 얼굴 ID가 잘못되었습니다.
충돌(409) DynamicPersonGroupExists 동적 사용자 그룹 ID <groupId> 가 이미 있습니다.

다음 단계