图像可识别性难度评级 | POST /grade/detection

根据图像的识别困难度打分，依次从 0 到 4，分值越大代表困难度越大。-1 代表图像不符规范导致识别错误（损坏或者白纸等情况）。

最佳实践是在创建新目标图像前需要调用这个接口。

Grade	描述
0 或 1	目标容易被检测
2	一般
3 或 4	目标难以被检测

Action

分为三个接口，一般仅以图搜图的话，只需要识别性方面的综合评级。

• POST /grade/detection

  • 仅给出识别性方面的综合结果

• POST /grade/tracking

  • 仅给出跟踪性方面的综合结果

• POST /grade/detail

  • 给出多维度详细算法评级

认证

需要

Http Header

Content-Type=application/json

HTTP Header: Authorization (当采用 API Key Token 方式认证)

请求参数

Field	Type	Required	Description
image	String(base64)	Yes	图像内容的 base64 编码字符串，支持 JPG 和 PNG 格式图像。图片最大 2MB。

返回字段

字段	描述
statusCode	状态码 0 表示认证正确，更多参考 状态码
result	错误消息，或者 grade
timestamp	响应返回时的服务器端时间。使用 Unix 时间戳格式，以毫秒为单位
result.grade	[-1, 0, 1, 2, 3, 4] 其中 0 和 1 表示容易识别。 4 最难识别。-1 代表图像不符合规范。

错误码

参见 状态码以及错误码大全

请求示例

    POST /grade/detection/ HTTP/1.1
    Host:
    Date: Mon, 1 Jan 2018 00:00:00 GMT
    Content-Type: application/json
    {
        "image":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM...",
        "timestamp": 1514736000000,
        "appKey": "test_app_key",
        "signature": "89985e2420899196db5bdf16b3c2ed0922c0c221"
    }

返回示例

    HTTP/1.1 200 OK
    Content-Type: application/json
    {
        "statusCode": 0,
        "result": {
            "grade": 1
        },
        "timestamp": 1514736000000
    }