需在face_detect接口的face_field参数中显式添加beauty字段，配合高质量正脸图像，才能获取0–100范围的颜值评分；多脸时各人脸独立评分，需校验quality指标与响应结构确保结果可靠。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您调用百度AI人脸识别接口时希望获取人脸的“颜值”评分，该能力实际包含在人脸检测接口返回的 beauty 字段中，需在请求参数中显式指定。以下是实现该功能的具体方法：
一、配置face_field参数启用beauty字段
百度AI人脸识别API默认不返回颜值评分，必须在调用 face_detect 接口时，于 face_field 参数中主动加入 beauty，系统才会计算并返回0–100范围内的标准化颜值分值（数值越高表示模型评估的面部美观度越强）。
1、构造请求参数时，在 face_field 字符串中添加 beauty，例如："age,gender,beauty,expression"
2、确保 image_type 为 base64 或 url，且 image 内容为清晰正脸人像，无严重遮挡或逆光
3、发送 POST 请求至 https://aip.baidubce.com/rest/2.0/face/v3/detect 接口
二、使用官方SDK简化调用流程
百度官方Python SDK（baidu-aip）已封装参数校验与字段控制逻辑，可避免手动拼接参数出错，直接支持 beauty 字段提取。
1、安装SDK：执行 pip install baidu-aip
2、初始化客户端，传入 app_id、api_key、secret_key
3、调用 detect 方法，options 参数中设置 {"face_field": "beauty"}
4、解析返回JSON，从 result['result']['face_list'][0]['beauty'] 中读取数值
三、验证图片质量以保障评分可靠性
beauty 分值受输入图像质量显著影响；百度API在 quality 字段中同步返回光照、模糊、遮挡等指标，若质量不达标，beauty 值将不可信或缺失。
1、请求时在 face_field 中同时加入 quality，例如："beauty,quality"
2、检查返回中的 quality 字段：确保 illumination > 40（光照充足）、blur （不模糊）、occlusion （遮挡轻微）
3、若 quality 不满足条件，应提示用户重拍，而非直接展示 beauty 值
四、处理多张人脸时的颜值取值逻辑
当一张图中检测到多张人脸，API按人脸区域大小降序排列 face_list，默认最多返回5张；beauty 值对应每张人脸独立计算，不存在聚合或平均。
1、确认 max_face_num 参数未设为1，否则仅返回最大人脸的 beauty
2、遍历 face_list 数组，对每个元素提取 face['beauty']
3、如需主视觉颜值，应选取 face['face_token'] 对应的首位结果；如需全部评分，须逐项解析
五、规避常见返回异常情形
beauty 字段并非总存在——当请求未声明、图片无效、人脸过小或姿态超标时，API可能省略该字段或返回 error_code 提示。
1、检查响应 status_code 是否为200，且 error_code 为0
2、校验 response.json() 中是否存在 result → face_list → [0] → beauty 路径
3、若 beauty 缺失，应捕获 KeyError 并反馈 "未检测到有效人脸或未启用颜值评分"
