圖像可識別性難度評級 | 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
}