本文介紹了調用圖片人工審核接口(/green/image/manual/asyncScan)進行人工審核的方法。內容安全除了提供機器識別服務外,還提供純人工審核服務,如果您對識別結果的準確率和召回率要求非常高,請使用人工審核功能。
(圖片人工審核)使用說明
業務接口:/green/image/manual/asyncScan
人工審核接口不實時返回檢測結果,您需要通過callback或輪詢方式獲取。檢測結果最長保留期限為30天。
計費信息:
該接口為收費接口。關于計費方式,請參見內容安全產品定價。
返回結果:
人工審核的返回結果時長根據待審核數據的量而定。
callback獲取審核結果:提交人工審核任務時,在請求參數中傳入callback參數,用來自動接收檢測結果。更多信息,請參見(人工審核)請求參數。
輪詢獲取審核結果:提交人工審核任務時,無需傳入callback參數。提交人工審核任務后,調用結果查詢接口獲取檢測結果。更多信息,請參見(圖片人工審核結果查詢)使用說明。
圖片要求:
圖片鏈接支持以下協議:HTTP和HTTPS。
圖片支持以下格式:PNG、JPG、JPEG、BMP、GIF、WEBP。
圖片大小限制為20 MB以內(適用于同步和異步調用),高度或者寬度不能超過30,000像素(px),且圖像總像素不超過2.5億px。
圖片下載時間限制為3秒內,如果下載時間超過3秒,返回下載超時。
請保證被檢測圖片所在的存儲服務穩定可靠,建議您使用阿里云OSS存儲或者CDN緩存等。
關于該接口的使用指南,請參見接入人工審核服務。
QPS限制
本接口的單用戶QPS限制為50次/秒。超過限制,API調用會被限流,這可能會影響您的業務,請合理調用。
(人工審核)請求參數
關于在請求中必須包含的公共請求參數,請參見公共參數。
請求body是一個JSON結構體,包含以下字段:
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
callback | String | 否 | http://www.aliyundoc.com | callback接口必須支持POST方法、UTF-8編碼的傳輸數據,以及表單參數checksum和content。內容安全按照以下規則和格式設置checksum和content,調用您的callback接口返回檢測結果。
說明 您的服務端callback接口收到內容安全推送的結果后,如果返回的HTTP狀態碼為200,則表示接收成功,其他的HTTP狀態碼均視為接收失敗。接收失敗時,內容安全將最多重復推送16次檢測結果,直到接收成功。重復推送16次后仍未接收成功,則不再推送,建議您檢查callback接口的狀態。 |
seed | String | 是 | seedxxx | 隨機字符串,該值用于回調通知請求中的簽名。 由英文字母、數字、下劃線(_)組成,不超過64個字符。由您自定義,用于在接收到內容安全的回調通知時校驗請求由阿里云內容安全服務發起。 說明 當使用callback時,該字段必須提供。 |
tasks | JSONArray | 否 | 指定檢測對象,JSON數組中的每個元素是一個檢測任務結構體。最多支持100個元素,即每次提交100條內容進行檢測,支持100個元素的前提是需要將并發任務調整到100個以上。關于每個元素的具體結構描述,請參見task。 |
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
url | String | 是 | http://www.aliyundoc.com/xxx.jpg | 檢測對象的URL。
|
dataId | String | 否 | dataIdxxxx | 檢測對象對應的數據ID。 由大小寫英文字母、數字、下劃線(_)、短劃線(-)、英文句號(.)組成,不超過128個字符,可以用于唯一標識您的業務數據。 |
(人工審核)返回數據
名稱 | 類型 | 示例值 | 描述 |
code | Integer | 200 | 錯誤碼,和HTTP狀態碼一致。 更多信息,請參見公共錯誤碼。 |
data | JSONArray | 本次請求返回的數據體。數組中每個元素表示一個人工審核任務的結果。關于每個元素的具體結構描述,請參見data。 | |
msg | String | OK | 本次請求的響應信息。 |
requestId | String | 147DE21C-6B0E-4331-87E9-77941376E109 | 請求ID。 |
名稱 | 類型 | 示例值 | 描述 |
code | Integer | 200 | 錯誤碼,和HTTP狀態碼一致。 更多信息,請參見公共錯誤碼。 |
dataId | String | dataIdxxxx | 檢測對象對應的數據ID。 說明 如果在檢測請求參數中傳入了dataId,則此處返回對應的dataId。 |
msg | String | OK | 該檢測任務的響應信息。 |
taskId | String | img6I5NQPVSQ7G4PsB79Z40iJ-1tyzUJ | 該人工審核任務的ID。后續您可以使用該ID調用結果接口,查詢人工審核任務的結果。 |
url | String | http://www.aliyundoc.com/xxx.jpg | 檢測對象的URL。
|
(人工審核)示例
請求示例
http(s)://[Endpoint]/green/image/manual/asyncScan
&<公共請求參數>
{
"callback": "http://www.aliyundoc.com",
"seed": "seedxxx",
"tasks": [{
"url": "http://www.aliyundoc.com/xxx.jpg",
"dataId": "dataIdxxxx"
}]
}
正常返回示例
{
"code": 200,
"data": [{
"code": 200,
"dataId": "dataIdxxxx",
"msg": "OK",
"taskId": "img6I5NQPVSQ7G4PsB79Z40iJ-1tyzUJ",
"url": "http://www.aliyundoc.com/xxx.jpg"
}],
"msg": "OK",
"requestId": "147DE21C-6B0E-4331-87E9-77941376E109"
}
(圖片人工審核結果查詢)使用說明
業務接口:/green/image/manual/scan/results,表示查詢圖片人工審核的結果。
QPS限制
本接口的單用戶QPS限制為50次/秒。超過限制,API調用會被限流,這可能會影響您的業務,請合理調用。
(結果查詢)請求參數
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
body | StringArray | 是 | ["img6I5NQPVSQ7G4PsB79Z40iJ-1tyzUJ"] | 要查詢的人工審核任務的taskId列表。數組中的元素個數不超過100個。 |
(結果查詢)返回數據
名稱 | 類型 | 示例值 | 描述 |
code | Integer | 200 | 錯誤碼,和HTTP狀態碼一致。 更多信息,請參見公共錯誤碼。 |
data | JSONArray | 本次請求返回的數據體。數組中每個元素表示一個人工審核任務的結果。關于每個元素的具體結構描述,請參見data。 | |
msg | String | OK | 本次請求的響應信息。 |
requestId | String | 1608A116-39C9-4080-A615-1E445DEF8841 | 請求ID。 |
名稱 | 類型 | 示例值 | 描述 |
code | Integer | 200 | 錯誤碼,和HTTP狀態碼一致。 更多信息,請參見公共錯誤碼。 |
dataId | String | dataIdxxxx | 檢測對象對應的數據ID。 說明 如果在檢測請求參數中傳入了dataId,則此處返回對應的dataId。 |
msg | String | OK | 該檢測任務的響應信息。 |
suggestion | String | block | 建議您執行的后續操作。取值:
|
taskId | String | img6I5NQPVSQ7G4PsB79Z40iJ-1tyzUJ | 任務ID。 |
url | String | http://www.aliyundoc.com/xxx.jpg | 檢測對象的URL。
|
(結果查詢)示例
請求示例
http(s)://[Endpoint]/green/image/manual/scan/results
&<公共請求參數>
[
"img6I5NQPVSQ7G4PsB79Z40iJ-1tyzUJ"
]
正常返回示例
{
"code": 200,
"data": [{
"code": 200,
"dataId": "dataIdxxxx",
"msg": "OK",
"suggestion": "block",
"taskId": "img6I5NQPVSQ7G4PsB79Z40iJ-1tyzUJ",
"url": "http://www.aliyundoc.com/xxx.jpg"
}],
"msg": "OK",
"requestId": "1608A116-39C9-4080-A615-1E445DEF8841"
}