跳到主要内容

人物种类识别

1. 任务简介​

1.1 任务 ID​

587c8ae7a4f48ed8f6f87dbb

提示

任务 ID 全局固定且不变，建议客户将其定义为代码常量。

1.2 能力介绍​

可对图片中的人物根据肤色进行人种识别。

2. 请求参数​

图片接口公共请求参数详见：图片同步识别接口，图片异步识别接口

视频接口公共请求参数详见：视频同步识别接口，视频文件异步识别接口，视频流异步识别接口

3. 返回结果​

3.1 公共返回结果​

图片接口公共返回结果详见：图片同步识别接口，图片异步识别接口

视频接口公共返回结果详见：视频同步识别接口，视频文件异步识别接口，视频流异步识别接口

3.2 任务返回结果 🎯​

任务结果​

参数名称类型是否必需说明
reviewCountInt是需要复审的图片数量
fileListArray<FileResult>是每张图片的识别结果，详见 FileResult 参数说明
statisticArray否各个分类的图片数量，数组索引是 label 值，元素值是数量；如 [1, 0, 0] 表示 label = 0的数量为 1，label = 1 的数量为 0 ，label = 2 的数量为 0。 任务返回 statistic, 就不返回 topNStatistic
topNStatisticArray否类别数多时，本次调用的全部图片，各个类别的图片数据分布。

1. 说明：由于部分任务标签数量较多，因此返回 topNStatistic, 不返回 statistic

FileResult 参数说明​

参数名称类型是否必需说明
rateFloat是分类得分，范围 [0.0, 1.0]， 值越高机器对判定结果越有把握
labelInt是识别分类（ -1 表示识别失败），详见任务返回标签说明
nameString是如果上传的 image 参数是 url ，则该值是图片 url ；如果是以图片文件上传，则该值为文件名
reviewBoolean是是否需要复审，true：需要，false：不需要
tagString否调用时为该图片设置的 tag 参数

3.3 任务返回标签说明 🎯🎯​

label 值说明
0白种人
1黄种人
2黑种人 或 棕种人
3其他

3.4 任务结果示例​

{
    "587c8ae7a4f48ed8f6f87dbb": {
        "reviewCount": 1,
        "fileList": [
            {
                "code": 0,
                "label": 1,
                "rate": 0.9925410606172397,
                "review": true,
                "file_name": "/cloud-api/storage-sw52/2025-05-22/12-7/682da832789f620094fcc251/17478873451310.3586665005423151.jpeg",
                "name": "https://tuputech.com/fake.jpg",
                "tag": "13"
            }
        ],
        "statistic": [
            0,
            1,
            0,
            0
        ]
    },
    "summary": [
        {
            "name": "https://tuputech.com/fake.jpg",
            "tag": "13",
            "suggestion": 0,
            "riskType": 0,
            "code": 0
        }
    ],
    "riskType": 0,
    "suggestion": 0,
    "code": 0,
    "message": "success",
    "nonce": "0.7773955176119316",
    "timestamp": 1747887345758
}