Skip to main content

​
📎 基本要求

项目要求推荐
文件格式PNG、JPG、JPEGJPG（文件较小）
文件大小最大3MB1MB以下
分辨率200x200 ~ 1999x1999px512x512px

​
👤 人脸要求

人脸完整性

  • 图片中必须包含清晰的人脸
  • 人脸不应被遮挡（如口罩、墨镜等）
  • 人脸不应被裁剪或模糊

人脸占比 & 角度

占比范围20% ~ 80%
偏航角±45°
俯仰角±30°

​
🌅 图片质量要求

☀️ 光线条件

  • 光线充足，避免过暗或过亮
  • 避免强烈的逆光或阴影
  • 确保人脸清晰可见

🌆 背景要求

  • 背景简洁，避免复杂图案
  • 避免与肤色相近的背景色
  • 确保人脸与背景有足够对比度

​
🖼️ 示例图片

​
✅ 有效图片示例

有效图片1

清晰人脸，角度合适，光线充足

有效图片2

人脸占比适中，背景简洁

​
❌ 无效图片示例

无效图片1

无人脸或人脸不清晰

无效图片2

人脸不完整或被遮挡

无效图片3

人脸被遮挡或模糊

​
⚠️ 常见错误

❎ 文件格式错误

{
    "error_code": 422,
    "error_code_str": "UNSUPPORTED_PARAMETER_VALUES",
    "error_detail": {
        "status_code": 422,
        "code": "UNSUPPORTED_PARAMETER_VALUES",
        "code_message": "Invalid parameter values.",
        "message": "Invalid parameter values. - image: Only PNG, JPG, JPEG, BMP are supported."
    },
    "error_msg": "Invalid parameter values. - image: Only PNG, JPG, JPEG, BMP are supported.",
    "log_id": "76947772",
    "request_id": "76947772"
}

🚫 无人脸检测

{
    "error_code": 422,
    "error_code_str": "FILE_CONTENT_NON_COMPLIANCE",
    "error_detail": {
        "code": "ERROR_NO_FACE_IN_FILE",
        "message": "pic not has face",
        "status_code": 422,
        "code_message": "No face detected in the file."
    },
    "error_msg": "File content does not meet requirements. - 222202 - pic not has face",
    "log_id": "76947794",
    "request_id": "3645368010"
}

📦 文件大小超限

{
    "error_code": 413,
    "error_code_str": "FILE_SIZE_EXCEEDS_LIMIT",
    "error_detail": {
        "status_code": 413,
        "code": "FILE_SIZE_EXCEEDS_LIMIT",
        "code_message": "File size exceeds limit.",
        "message": "File size exceeds limit. - image: No larger than 8 M."
    },
    "error_msg": "File size exceeds limit. - image: No larger than 8 M.",
    "log_id": "76947844",
    "request_id": "76947844"
}

​
💡 最佳实践

​
🔍 预处理图片

在上传前对图片进行适当的裁剪和调整

​
✅ 检查质量

确保图片清晰，人脸完整可见

​
🧪 测试验证

使用人脸分析 API 预先验证图片质量

阿里云人脸检测

​
📦 批量处理

对于批量处理，确保所有图片都符合要求