请求方式:POST (HTTPS)
请求地址:
https://open.welink.huaweicloud.com/api/aiservice/v1/moderation/text
认证方式: access_token,请参考获取access_token
请求头部:
Content-Type: application/json
x-wlk-Authorization: access_token
请求参数
{
"categories":["ad","politics","abuse","porn","contraband","flood"],
"items":[
{
"text": "6666666666",
"type": "content"
}
]
}
请求参数说明
参数 | 必选 | 参数类型 | 说明 |
---|---|---|---|
items | 是 | Dictionary | 待检测的文本列表,目前暂时每次只支持传一个item。 |
text | 是 | String | 待检测文本,编码格式为“utf-8”,限定5000个字符以内,文本长度超过5000个字符时,只检测前5000个字符。 |
type | 否 | String | 文本类型,默认为“content”,即正文内容,当前只支持“content”类型,未来会扩大支持类型范围。 |
categories | 否 | Array[String] | 检测场景。当前支持的场景有默认场景:politics 涉政, porn 涉黄, ad 广告, abuse 辱骂,contraband 违禁品, flood 灌水 |
请求示例
curl -X POST \
'https://open.welink.huaweicloud.com/api/aiservice/v1/moderation/text' \
-H 'Accept-Charset: UTF-8' \
-H 'Content-Type: application/json' \
-H 'x-wlk-Authorization: access_token' \
-d '{ "categories":["ad","politics","abuse","porn","contraband","flood"],
"items":[
{
"text": "6666666666",
"type": "content"
}
]}'
响应格式说明
返回结果 正常返回结果
{
"code": "0",
"data": {
"detail": {
"flood": "6666666666"
},
"suggestion": "block"
},
"error": "",
"message": "ok"
}
异常返回结果
失败响应示例
{
"code": "58401",
"data": null,
"error": "Failed to verify the token.",
"message": "Login authentication failed."
}
返回参数说明
- 响应参数说明
参数 | 必选 | 参数类型 | 说明 |
---|---|---|---|
code | 是 | String | 错误码 |
message | 是 | String | 调用成功时为"ok"。调用失败时的错误信息。 |
data | 是 | Object | 调用成功时表示调用结果,详见data数据结构。调用失败时为null。 |
error | 是 | String | 错误信息。 |
data 数据结构
参数 | 必选 | 参数类型 | 说明 |
---|---|---|---|
detail | 是 | Object | 返回的相关检测结果详细信息:politics 涉政, porn 涉黄, ad 广告, abuse 辱骂,contraband 违禁品, flood 灌水。灌水文本最多显示200个字符。 |
suggestion | 是 | String | 检测结果是否通过。 block:包含敏感信息,不通过。 pass:不包含敏感信息,通过。 review:需要人工复查。 |
错误码说明
错误码 | 说明 |
---|---|
0 | 成功。 |
58401 | 无权限。 |
58402 | 非法输入参数。 |
58500 | 服务异常。 |
58005 | Moderation服务异常。 |