Códigos de error de Face API de Azure AI
Códigos de error comunes
Estas llamadas a Face API pueden devolver estos códigos de error.
| Código de estado HTTP | Código de error | Mensaje de error | Descripción |
|---|---|---|---|
| Solicitud incorrecta (400) | BadArgument | El cuerpo de la solicitud no es válido. | |
| Solicitud incorrecta (400) | BadArgument | Error de análisis de JSON. | Cuerpo JSON de solicitud incorrecto o no reconocido. |
| Solicitud incorrecta (400) | BadArgument | "recognitionModel" no es válido. | |
| Solicitud incorrecta (400) | BadArgument | "detectionModel" no es válido. | |
| Solicitud incorrecta (400) | BadArgument | 'name' está vacío. | |
| Solicitud incorrecta (400) | BadArgument | 'name' es demasiado largo. | |
| Solicitud incorrecta (400) | BadArgument | "userData" es demasiado largo. | |
| Solicitud incorrecta (400) | BadArgument | 'start' es demasiado largo. | |
| Solicitud incorrecta (400) | BadArgument | 'top' no es válido. | |
| Solicitud incorrecta (400) | BadArgument | TargetFace de argumento fuera del intervalo. | |
| Solicitud incorrecta (400) | BadArgument | TargetFace de argumento no válido. | Causado por un formato de cadena no válido o por un valor de alto/ancho o izquierdo no válido. |
| Solicitud incorrecta (400) | InvalidURL | Dirección URL de imagen no válida. | Entre los formatos admitidos se incluyen JPEG, PNG, GIF(el primer fotograma) y BMP. |
| Solicitud incorrecta (400) | InvalidURL | Dirección URL de imagen no válida o error al descargar desde el servidor de destino. Error de servidor remoto devuelto: "Error al enviar la solicitud". | |
| Solicitud incorrecta (400) | InvalidImage | Error de descodificación, formato de imagen no admitido. | |
| Solicitud incorrecta (400) | InvalidImage | No se detectó ninguna cara en la imagen. | |
| Solicitud incorrecta (400) | InvalidImage | Hay más de 1 cara en la imagen. | |
| Solicitud incorrecta (400) | InvalidImageSize | El tamaño de la imagen es demasiado pequeño. | El tamaño de archivo de imagen válido debe ser mayor o igual que 1 KB. |
| Solicitud incorrecta (400) | InvalidImageSize | El tamaño de la imagen es demasiado grande. | El tamaño de archivo de imagen válido no debe tener más de 6 MB. |
| No autorizado (401) | 401 | Acceso denegado debido a una clave de suscripción no válida o a un punto de conexión de API incorrecto. Asegúrese de proporcionar una clave válida para una suscripción activa y de usar un punto de conexión de API regional correcto para el recurso. | |
| Prohibido (403) | UnsupportedFeature | No se admite la característica, falta la aprobación de una o varias de las siguientes características: Identificación, Comprobación. | Regístrese para obtener acceso mediante el envío de un formulario de registro. |
| Conflicto (409) | ConcurrentOperationConflict | Hay una operación de conflicto en el recurso <resourceName>, pruebe más adelante. |
|
| Demasiadas solicitudes (429) | 429 | Rate limit is exceeded. (El límite de velocidad se ha excedido.) |
Códigos de error de detección de caras
La operación detección de caras puede devolver estos códigos de error.
| Código de estado HTTP | Código de error | Mensaje de error | Descripción |
|---|---|---|---|
| Solicitud incorrecta (400) | BadArgument | Argumento returnFaceAttributes no válido. | |
| Solicitud incorrecta (400) | BadArgument | "returnFaceAttributes" no es compatible con detection_02. | |
| Solicitud incorrecta (400) | BadArgument | "returnLandmarks" no es compatible con detection_02. | |
| Prohibido (403) | UnsupportedFeature | Los atributos devueltos (emoción, sexo, edad, sonrisa, cabello facial, cabello y maquillaje) han quedado en desuso y ya no se admiten. | Aquí puede encontrar más información sobre esta decisión. |
Códigos de error de sesión de Face Liveness
Estas operaciones de sesión de Face Liveness pueden devolver estos códigos de error.
| Código de estado HTTP | Código de error | Mensaje de error | Descripción |
|---|---|---|---|
| Solicitud incorrecta (400) | BadArgument | El parámetro Start no es válido. Especifique el campo "Id" de la última entrada para continuar con el proceso de descripción. | |
| Solicitud incorrecta (400) | BadArgument | El parámetro top no es válido. El intervalo válido está comprendido entre 1 y 1000 inclusive. | |
| Solicitud incorrecta (400) | InvalidRequestBody | Cuerpo de solicitud incorrecto proporcionado. Compruebe el esquema de la operación e inténtelo de nuevo. | |
| Solicitud incorrecta (400) | InvalidTokenLifetime | authTokenTimeToLiveInSeconds no válidos especificados. Debe estar comprendido entre 60 y 86400. | |
| Solicitud incorrecta (400) | InvalidLivenessOperationMode | Se especificó livenessOperationMode no válido. Debe ser "Pasivo". | |
| Solicitud incorrecta (400) | InvalidDeviceCorrelationId | Se requiere un identificador de correlación de dispositivo en el cuerpo de la solicitud durante el inicio de la sesión o la creación de la sesión. No debe ser null ni estar vacío y no tener más de 64 caracteres. | |
| No encontrado (404) | SessionNotFound | No se encuentra el identificador de sesión. El identificador de sesión ha expirado o no existe. |
Códigos de error de Face Identify
La operación Face Identify puede devolver estos códigos de error.
| Código de estado HTTP | Código de error | Mensaje de error | Descripción |
|---|---|---|---|
| Solicitud incorrecta (400) | BadArgument | 'recognitionModel' no es compatible. | |
| Solicitud incorrecta (400) | BadArgument | El identificador de grupo de personas no es válido. | |
| Solicitud incorrecta (400) | BadArgument | El identificador de grupo de personas grandes no es válido. | |
| Solicitud incorrecta (400) | BadArgument | El identificador de grupo de personas dinámico no es válido. | |
| Solicitud incorrecta (400) | BadArgument | El argumento maxNumOfCandidatesReturned no es válido. | El intervalo válido está entre [1, 100]. |
| Solicitud incorrecta (400) | BadArgument | El argumento confidenceThreshold no es válido. | El intervalo válido está entre [0, 1]. |
| Solicitud incorrecta (400) | BadArgument | La longitud de faceIds no está en un intervalo válido. | El intervalo válido está entre [1, 10]. |
| Solicitud incorrecta (400) | FaceNotFound | No se encuentra la cara. | |
| Solicitud incorrecta (400) | PersonGroupNotFound | No se encuentra el grupo de personas. | |
| Solicitud incorrecta (400) | LargePersonGroupNotFound | No se encuentra el grupo de personas grandes. | |
| Solicitud incorrecta (400) | DynamicPersonGroupNotFound | No se encuentra el grupo de personas dinámicas. | |
| Solicitud incorrecta (400) | PersonGroupNotTrained | Grupo de personas no entrenado. | |
| Solicitud incorrecta (400) | LargePersonGroupNotTrained | Grupo de personas grandes no entrenado. | |
| Solicitud incorrecta (400) | PersonGroupIdAndLargePersonGroupIdBothNotNull | El identificador de grupo de personas grandes y el identificador de grupo de personas no son NULL. | |
| Solicitud incorrecta (400) | PersonGroupIdAndLargePersonGroupIdBothNull | El identificador de grupo de personas grandes y el identificador de grupo de personas son null. | |
| Solicitud incorrecta (400) | MissingIdentificationScopeParameters | No hay ningún parámetro de ámbito de identificación presente en la solicitud. | |
| Solicitud incorrecta (400) | IncompatibleIdentificationScopeParametersCombination | Los parámetros de ámbito de identificación incompatibles están presentes en la solicitud. | |
| Conflicto (409) | PersonGroupTrainingNotFinished | El grupo de personas está en entrenamiento. | |
| Conflicto (409) | LargePersonGroupTrainingNotFinished | El grupo de personas grandes está en entrenamiento. |
Códigos de error de Face Verify
La operación Face Verify puede devolver estos códigos de error.
| Código de estado HTTP | Código de error | Mensaje de error | Descripción |
|---|---|---|---|
| Solicitud incorrecta (400) | BadArgument | 'recognitionModel' no es compatible. | |
| Solicitud incorrecta (400) | BadArgument | Face ID no es válido. | Un faceId válido procede de Face - Detect. |
| Solicitud incorrecta (400) | BadArgument | El identificador de persona no es válido. | Se genera un personId válido a partir de Crear persona del grupo de personas, Crear persona de grupo grande o Directorio de personas: crear persona. |
| Solicitud incorrecta (400) | BadArgument | El identificador de grupo de personas no es válido. | |
| Solicitud incorrecta (400) | BadArgument | El identificador de grupo de personas grandes no es válido. | |
| Solicitud incorrecta (400) | PersonNotFound | No se encuentra la persona. | |
| Solicitud incorrecta (400) | PersonGroupNotFound | No se encuentra el grupo de personas. | |
| Solicitud incorrecta (400) | LargePersonGroupNotFound | No se encuentra el grupo de personas grandes. | |
| No encontrado (404) | FaceNotFound | No se encuentra la cara. | |
| No encontrado (404) | PersonNotFound | No se encuentra la persona. | |
| No encontrado (404) | PersistedFaceNotFound | No se encuentra ninguna cara persistente de la persona. |
Buscar códigos de error similares
La operación Face Find Similar puede devolver estos códigos de error.
| Código de estado HTTP | Código de error | Mensaje de error | Descripción |
|---|---|---|---|
| Solicitud incorrecta (400) | BadArgument | 'recognitionModel' no es compatible. | |
| Solicitud incorrecta (400) | BadArgument | El modo no es válido. | |
| Solicitud incorrecta (400) | BadArgument | El identificador de lista de caras no es válido. | |
| Solicitud incorrecta (400) | BadArgument | El identificador de lista de caras grandes no es válido. | |
| Solicitud incorrecta (400) | BadArgument | LargeFaceListId, faceListId y faceIds, no exactamente uno de ellos es válido. | |
| Solicitud incorrecta (400) | BadArgument | LargeFaceListId, faceListId y faceIds son null. | |
| Solicitud incorrecta (400) | BadArgument | 2 o más de largeFaceListId, faceListId y faceIds no son NULL. | |
| Solicitud incorrecta (400) | BadArgument | El argumento maxNumOfCandidatesReturned no es válido. | El intervalo válido está entre [1, 1000]. |
| Solicitud incorrecta (400) | BadArgument | La longitud de faceIds no está en un intervalo válido. | El intervalo válido está entre [1, 1000]. |
| Solicitud incorrecta (400) | FaceNotFound | No se encuentra la cara. | |
| Solicitud incorrecta (400) | FaceListNotFound | No se encuentra la lista de caras. | |
| Solicitud incorrecta (400) | LargeFaceListNotFound | No se encuentra la lista de caras grandes. | |
| Solicitud incorrecta (400) | LargeFaceListNotTrained | La lista de caras grandes no está entrenada. | |
| Solicitud incorrecta (400) | FaceListNotReady | La lista de caras está vacía. | |
| Conflicto (409) | LargeFaceListTrainingNotFinished | La lista de caras grandes está en entrenamiento. |
Códigos de error del grupo de caras
La operación Face Group puede devolver estos códigos de error.
| Código de estado HTTP | Código de error | Mensaje de error | Descripción |
|---|---|---|---|
| Solicitud incorrecta (400) | BadArgument | 'recognitionModel' no es compatible. | |
| Solicitud incorrecta (400) | BadArgument | La longitud de faceIds no está en un intervalo válido. | El intervalo válido está entre [2, 1000]. |
Operaciones de grupo de personas
Estas operaciones de grupo de personas pueden devolver estos códigos de error.
Códigos de error del grupo de personas
| Código de estado HTTP | Código de error | Mensaje de error | Descripción |
|---|---|---|---|
| Solicitud incorrecta (400) | BadArgument | El identificador de grupo de personas no es válido. | El carácter válido es letra inglesa en minúsculas, dígitos, "-" o "_". La longitud máxima es 64. |
| Prohibido (403) | QuotaExceeded | El número de grupo de personas alcanzó el límite de nivel de suscripción. | |
| Prohibido (403) | QuotaExceeded | El número de persona alcanzó el límite de nivel de grupo de personas. | |
| Prohibido (403) | QuotaExceeded | El número de persona alcanzó el límite de nivel de suscripción. | |
| Prohibido (403) | QuotaExceeded | Se alcanzó el límite de número de cara persistente. | |
| No encontrado (404) | PersonGroupNotFound | No se encuentra el grupo de personas. | |
| No encontrado (404) | PersonGroupNotFound | El identificador de grupo de personas no es válido. | |
| No encontrado (404) | PersonNotFound | No se encuentra la persona <personId> . |
|
| No encontrado (404) | PersonNotFound | El identificador de persona no es válido. | |
| No encontrado (404) | PersistedFaceNotFound | No se encuentra la cara persistente. | |
| No encontrado (404) | PersistedFaceNotFound | No se encuentra la cara <faceId> persistente. |
|
| No encontrado (404) | PersistedFaceNotFound | El identificador de cara persistente no es válido. | |
| No encontrado (404) | PersonGroupNotTrained | Grupo de personas no entrenado. | Este error aparece al obtener el estado de entrenamiento de un grupo que nunca se ha entrenado. |
| Conflicto (409) | PersonGroupExists | El grupo de personas ya existe. | |
| Conflicto (409) | PersonGroupTrainingNotFinished | El grupo de personas está en entrenamiento. | Inténtelo de nuevo después de completar el entrenamiento. |
Códigos de error del grupo de personas grandes
| Código de estado HTTP | Código de error | Mensaje de error | Descripción |
|---|---|---|---|
| Solicitud incorrecta (400) | BadArgument | El identificador de grupo de personas grandes no es válido. | El carácter válido es letra inglesa en minúsculas, dígitos, "-" o "_". La longitud máxima es 64. |
| Solicitud incorrecta (400) | BadArgument | Tanto 'name' como 'userData' están vacíos. | |
| Prohibido (403) | QuotaExceeded | El número de grupo de personas grandes alcanzó el límite de nivel de suscripción. | |
| Prohibido (403) | QuotaExceeded | El número de persona alcanzó el límite de nivel de grupo de personas grandes. | |
| Prohibido (403) | QuotaExceeded | El número de persona alcanzó el límite de nivel de suscripción. | |
| Prohibido (403) | QuotaExceeded | Se alcanzó el límite de número de cara persistente. | |
| No encontrado (404) | LargePersonGroupNotFound | No se encuentra el grupo de personas grandes. | |
| No encontrado (404) | LargePersonGroupNotFound | El identificador de grupo de personas grandes no es válido. | |
| No encontrado (404) | PersonNotFound | No se encuentra la persona <personId> . |
|
| No encontrado (404) | PersonNotFound | El identificador de persona no es válido. | |
| No encontrado (404) | PersistedFaceNotFound | No se encuentra la cara persistente. | |
| No encontrado (404) | PersistedFaceNotFound | No se encuentra la cara <faceId> persistente. |
|
| No encontrado (404) | PersistedFaceNotFound | El identificador de cara persistente no es válido. | |
| No encontrado (404) | LargePersonGroupNotTrained | Grupo de personas grandes no entrenado. | Este error aparece al obtener el estado de entrenamiento de un grupo que nunca se ha entrenado. |
| Conflicto (409) | LargePersonGroupExists | Ya existe un grupo de personas grandes. | |
| Conflicto (409) | LargePersonGroupTrainingNotFinished | El grupo de personas grandes está en entrenamiento. | Inténtelo de nuevo después de completar el entrenamiento. |
Operaciones de lista de caras
Estas operaciones de Face List pueden devolver estos códigos de error.
Códigos de error de la lista de caras
| Código de estado HTTP | Código de error | Mensaje de error | Descripción |
|---|---|---|---|
| Solicitud incorrecta (400) | BadArgument | El identificador de lista de caras no es válido. | El carácter válido es letra inglesa en minúsculas, dígitos, "-" o "_". La longitud máxima es 64. |
| Prohibido (403) | QuotaExceeded | Se alcanzó el límite de número de cara persistente. | |
| No encontrado (404) | FaceListNotFound | No se encuentra la lista de caras. | |
| No encontrado (404) | FaceListNotFound | El identificador de lista de caras no es válido. | |
| No encontrado (404) | PersistedFaceNotFound | No se encuentra la cara persistente. | |
| No encontrado (404) | PersistedFaceNotFound | El identificador de cara persistente no es válido. | |
| Conflicto (409) | FaceListExists | La lista de caras ya existe. |
Códigos de error de la lista de caras grandes
| Código de estado HTTP | Código de error | Mensaje de error | Descripción |
|---|---|---|---|
| Solicitud incorrecta (400) | BadArgument | El identificador de lista de caras grandes no es válido. | El carácter válido es letra inglesa en minúsculas, dígitos, "-" o "_". La longitud máxima es 64. |
| Solicitud incorrecta (400) | BadArgument | Tanto 'name' como 'userData' están vacíos. | |
| Prohibido (403) | QuotaExceeded | El número de lista de caras grandes alcanzó el límite. | |
| Prohibido (403) | QuotaExceeded | Se alcanzó el límite de número de cara persistente. | |
| No encontrado (404) | LargeFaceListNotFound | No se encuentra la lista de caras grandes. | |
| No encontrado (404) | LargeFaceListNotFound | El identificador de lista de caras grandes no es válido. | |
| No encontrado (404) | PersistedFaceNotFound | No se encuentra la cara de lista de caras <faceId> grandes. |
|
| No encontrado (404) | PersistedFaceNotFound | El identificador de cara persistente no es válido. | |
| No encontrado (404) | LargeFaceListNotTrained | Lista de caras grandes no entrenada. | Este error aparece al obtener el estado de entrenamiento de una lista de caras grande que nunca se ha entrenado. |
| Conflicto (409) | LargeFaceListExists | Ya existe una lista de caras grandes. | |
| Conflicto (409) | LargeFaceListTrainingNotFinished | La lista de caras grandes está en entrenamiento. | Inténtelo de nuevo después de completar el entrenamiento. |
Operaciones de Directorio de personas
Las operaciones de Person Directory pueden devolver estos códigos de error.
Códigos de error de Person Directory
| Código de estado HTTP | Código de error | Mensaje de error | Descripción |
|---|---|---|---|
| Solicitud incorrecta (400) | BadArgument | El modelo de reconocimiento no se admite para esta característica. | |
| Solicitud incorrecta (400) | BadArgument | 'start' no es un identificador de persona válido. | |
| Solicitud incorrecta (400) | BadArgument | Tanto 'name' como 'userData' están vacíos. | |
| Solicitud incorrecta (400) | DynamicPersonGroupNotFound | El identificador de grupo de personas dinámico no es válido. | |
| Prohibido (403) | QuotaExceeded | El número de persona alcanzó el límite de nivel de suscripción. | |
| Prohibido (403) | QuotaExceeded | Se alcanzó el límite de número de cara persistente. | |
| No encontrado (404) | DynamicPersonGroupNotFound | No se encontró el grupo de personas dinámicas. | |
| No encontrado (404) | DynamicPersonGroupNotFound | No se encuentra DynamicPersonGroupPersonReference <groupId> . |
|
| No encontrado (404) | PersonNotFound | No se encuentra la persona. | |
| No encontrado (404) | PersonNotFound | El identificador de persona no es válido. | |
| No encontrado (404) | PersistedFaceNotFound | No se encuentra la cara persistente. | |
| No encontrado (404) | PersistedFaceNotFound | No se encuentra la cara <faceId> persistente. |
|
| No encontrado (404) | PersistedFaceNotFound | Face ID persistente no es válido. | |
| Conflicto (409) | DynamicPersonGroupExists | El identificador <groupId> de grupo de personas dinámicas ya existe. |
Pasos siguientes