文本人工審核
本文介紹了調(diào)用文本人工審核接口(/green/text/manual/asyncScan)進行人工審核的方法。內(nèi)容安全除了提供機器識別服務(wù)外,還提供純?nèi)斯徍朔?wù),如果您對識別結(jié)果的準確率和召回率要求非常高,請使用人工審核功能。
使用該服務(wù)前,請聯(lián)系我們的商務(wù)經(jīng)理,進一步確定審核標準與內(nèi)容范圍。調(diào)用該接口不會返回機器識別結(jié)果,如果您需要機器識別的結(jié)果,請調(diào)用檢測服務(wù)接口。檢測服務(wù)的接口信息,請參見文本同步檢測。
(文本人工審核)使用說明
業(yè)務(wù)接口:/green/text/manual/asyncScan
人工審核接口不實時返回檢測結(jié)果,您需要通過callback或輪詢方式獲取。檢測結(jié)果最長保留期限為30天。
計費信息:
該接口為收費接口。關(guān)于計費方式,請參見內(nèi)容安全產(chǎn)品定價。
返回結(jié)果:
人工審核的返回結(jié)果時長根據(jù)待審核數(shù)據(jù)的量而定。
callback獲取審核結(jié)果:提交人工審核任務(wù)時,在請求參數(shù)中傳入callback參數(shù),用來自動接收檢測結(jié)果。更多信息,請參見請求參數(shù)。
輪詢獲取審核結(jié)果:提交人工審核任務(wù)時,無需傳入callback參數(shù)。提交人工審核任務(wù)后,調(diào)用結(jié)果查詢接口獲取檢測結(jié)果。更多信息,請參見結(jié)果查詢接口說明。
關(guān)于該接口的使用指南,請參見接入人工審核服務(wù)。
QPS限制
本接口的單用戶QPS限制為50次/秒。超過限制,API調(diào)用會被限流,這可能會影響您的業(yè)務(wù),請合理調(diào)用。
(人工審核)請求參數(shù)
關(guān)于在請求中必須包含的公共請求參數(shù),請參見公共參數(shù)。
請求body是一個JSON結(jié)構(gòu)體,包含以下字段:
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
callback | String | 否 | http://aliyundoc.com | callback接口必須支持POST方法、UTF-8編碼的傳輸數(shù)據(jù),以及表單參數(shù)checksum和content。內(nèi)容安全按照以下規(guī)則和格式設(shè)置checksum和content,調(diào)用您的callback接口返回檢測結(jié)果。
說明 您的服務(wù)端callback接口收到內(nèi)容安全推送的結(jié)果后,如果返回的HTTP狀態(tài)碼為200,則表示接收成功,其他的HTTP狀態(tài)碼均視為接收失敗。接收失敗時,內(nèi)容安全將最多重復(fù)推送16次檢測結(jié)果,直到接收成功。重復(fù)推送16次后仍未接收成功,則不再推送,建議您檢查callback接口的狀態(tài)。 |
seed | String | 是 | seedxxx | 隨機字符串,該值用于回調(diào)通知請求中的簽名。 由英文字母、數(shù)字、下劃線(_)組成,不超過64個字符。由您自定義,用于在接收到內(nèi)容安全的回調(diào)通知時校驗請求由阿里云內(nèi)容安全服務(wù)發(fā)起。 說明 當(dāng)使用callback時,該字段必須提供。 |
tasks | JSONArray | 否 | 指定檢測對象,JSON數(shù)組中的每個元素是一個檢測任務(wù)結(jié)構(gòu)體。最多支持100個元素,即每次提交100條內(nèi)容進行檢測,支持100個元素的前提是需要將并發(fā)任務(wù)調(diào)整到100個以上。關(guān)于每個元素的具體結(jié)構(gòu)描述,請參見task。 |
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
content | String | 是 | test | 待人工審核的文本內(nèi)容,最長不超過10000個字符(包含中文、英文和標點符號)。 |
dataId | String | 否 | dataIdxxxx | 檢測對象對應(yīng)的數(shù)據(jù)ID。 由大小寫英文字母、數(shù)字、下劃線(_)、短劃線(-)、英文句號(.)組成,不超過128個字符,可以用于唯一標識您的業(yè)務(wù)數(shù)據(jù)。 |
(人工審核)返回數(shù)據(jù)
名稱 | 類型 | 示例值 | 描述 |
code | Integer | 200 | 錯誤碼,和HTTP狀態(tài)碼一致。 更多信息,請參見公共錯誤碼。 |
data | JSONArray | 本次請求返回的數(shù)據(jù)體。數(shù)組中每個元素表示一個人工審核任務(wù)的結(jié)果。關(guān)于每個元素的具體結(jié)構(gòu)描述,請參見data。 | |
msg | String | OK | 本次請求的響應(yīng)信息。 |
requestId | String | 2C01A0EE-B5BF-429B-898A-9F6D301342EB | 請求ID。 |
名稱 | 類型 | 示例值 | 描述 |
code | Integer | 200 | 錯誤碼,和HTTP狀態(tài)碼一致。 更多信息,請參見公共錯誤碼。 |
dataId | String | dataIdxxxx | 檢測對象對應(yīng)的數(shù)據(jù)ID。 說明 如果在檢測請求參數(shù)中傳入了dataId,則此處返回對應(yīng)的dataId。 |
msg | String | OK | 該檢測任務(wù)的響應(yīng)信息。 |
taskId | String | txt17xfqjr4XWx4FrfsGw5YxL-1tyzBX | 該人工審核任務(wù)的ID。后續(xù)您可以使用該ID調(diào)用結(jié)果接口,查詢?nèi)斯徍巳蝿?wù)的結(jié)果。 |
content | String | text | 待人工審核的文本內(nèi)容,最長不超過10000個字符(包含中文、英文和標點符號)。 |
(人工審核)示例
請求示例
http(s)://[Endpoint]/green/text/manual/asyncScan
&<公共請求參數(shù)>
{
"callback": "http://aliyundoc.com",
"seed": "seedxxx",
"tasks": [{
"content": "test text",
"dataId": "dataIdxxxx"
}]
}
正常返回示例
{
"code": 200,
"data": [{
"code": 200,
"content": "test text",
"dataId": "dataIdxxxx",
"msg": "OK",
"taskId": "txt17xfqjr4XWx4FrfsGw5YxL-1tyzBX"
}],
"msg": "OK",
"requestId": "2C01A0EE-B5BF-429B-898A-9F6D301342EB"
}
(文本人工審核結(jié)果查詢)使用說明
業(yè)務(wù)接口:/green/text/manual/scan/results,表示查詢文本人工審核的結(jié)果。
QPS限制
本接口的單用戶QPS限制為50次/秒。超過限制,API調(diào)用會被限流,這可能會影響您的業(yè)務(wù),請合理調(diào)用。
(結(jié)果查詢)請求參數(shù)
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
body | StringArray | 是 | ["txt17xfqjr4XWx4FrfsGw5YxL-1tyzBX"] | 待查詢的人工審核任務(wù)的taskId列表。數(shù)組中的元素個數(shù)不超過100個。 |
(結(jié)果查詢)返回數(shù)據(jù)
名稱 | 類型 | 示例值 | 描述 |
code | Integer | 200 | 錯誤碼,和HTTP狀態(tài)碼一致。 更多信息,請參見公共錯誤碼。 |
data | JSONArray | 本次請求返回的數(shù)據(jù)體。數(shù)組中每個元素表示一個人工審核任務(wù)的結(jié)果。關(guān)于每個元素的具體結(jié)構(gòu)描述,請參見data。 | |
msg | String | OK | 本次請求的響應(yīng)信息。 |
requestId | String | 2061F868-396C-4F00-9F32-792914428EA1 | 請求ID。 |
名稱 | 類型 | 示例值 | 描述 |
code | Integer | 200 | 錯誤碼,和HTTP狀態(tài)碼一致。 更多信息,請參見公共錯誤碼。 |
dataId | String | dataIdxxxx | 檢測對象對應(yīng)的數(shù)據(jù)ID。 說明 如果在檢測請求參數(shù)中傳入了dataId,則此處返回對應(yīng)的dataId。 |
msg | String | OK | 該檢測任務(wù)的響應(yīng)信息。 |
suggestion | String | block | 建議您執(zhí)行的后續(xù)操作。取值:
|
taskId | String | txt17xfqjr4XWx4FrfsGw5YxL-1tyzBX | 任務(wù)ID。 |
content | String | test text xxx | 人工審核的文本內(nèi)容。 |
(結(jié)果查詢)示例
請求示例
http(s)://[Endpoint]/green/text/manual/scan/results
&<公共請求參數(shù)>
[
"txt17xfqjr4XWx4FrfsGw5YxL-1tyzBX"
]
正常返回示例
{
"code": 200,
"data": [{
"code": 200,
"content": "test text xxx",
"dataId": "dataIdxxxx",
"msg": "OK",
"suggestion": "block",
"taskId": "txt17xfqjr4XWx4FrfsGw5YxL-1tyzBX"
}],
"msg": "OK",
"requestId": "2061F868-396C-4F00-9F32-792914428EA1"
}