接口描述

此接口用于请求图像审核服务。图像审核服务是百度智能云对外提供的图像智能审核服务，支持对图像的多个维度进行审核，包括色情识别、暴恐识别、政治敏感识别、恶心图识别、广告识别等。

说明：使用本接口需要先在控制台开通图像审核服务，详情请参见开通图像审核服务。

请求

• 请求语法

    POST /<ObjectName>?process HTTP/1.1
    Host: <BucketName>.bj.bcebos.com
    Date: <Date>
    Authorization: <AuthorizationString>
    Content-Type: application/json; charset=utf-8
    Content-Length: <ContentLength>
  
    {
        "action" : {
            "sync" : [{
                    "url" : "$(img-censor)",
                    "parameters" : "<base64_encode(param)>",
  
                }
            ]
        }
    }

• 请求参数

  • url：固定取值为 $(img-censor)，不需要修改。

  • parameters：此项值是对图像审核功能参数进行 base64 编码而成。图像审核功能参数依然是个 json 字符串。

    图像审核功能参数基本结构：

     {
       "antiporn" : {},
       "terror" : {},
       "ocr" : {
           "detect_direction" : "false",
           "language_type" : "CHN_ENG",
           "recognize_granularity" : "big"
       }
     }

    可以为多个子服务的按需任意组合，也可以为单个子服务如“鉴黄”，此时参数写成

    {
        "antiporn" : {}
    }

    图像审核服务支持的子服务列表有：

    • ocr：通用文字识别
    • face：人脸探测
    • antiporn：色情识别
    • politician：政治人物识别
    • terror：暴恐识别
    • public: 公众人物识别
    • disgust: 恶心图识别
    • watermark：水印二维码识别
    • quality：图像质量识别 value 为各底层服务参数，参照河图 OCR 通用文字识别服务入参。

    详细的子服务请求参数及返回参数解释参见下文详细解释。

• 请求头域

  无

响应

• 响应头域

  无

• 响应元素

  参见各子服务的返回参数解释。

示例

• 请求示例

{
    "antiporn": {},
    "ocr": {
        "detect_direction": "false",
        "language_type": "CHN_ENG",
        "recognize_granularity": "big"
    }
}

base64 编码后

eyJhbnRpcG9ybiI6e30sIm9jciI6eyJkZXRlY3RfZGlyZWN0aW9uIjoiZmFsc2UiLCJsYW5ndWFnZV90eXBlIjoiQ0hOX0VORyIsInJlY29nbml6ZV9ncmFudWxhcml0eSI6ImJpZyJ9fQ==

填充到 parameters 中，发送的请求如下：

POST /<ObjectName>?process HTTP/1.1
Host: <BucketName>.bj.bcebos.com
Date: <Date>
Authorization: <AuthorizationString>
Content-Type: application/json; charset=utf-8
Content-Length: <ContentLength>

{
    "action" : {
        "sync" : [{
                "url" : "$(img-censor)",
                "parameters" : "eyJhbnRpcG9ybiI6e30sIm9jciI6eyJkZXRlY3RfZGlyZWN0aW9uIjoiZmFsc2UiLCJsYW5ndWFnZV90eXBlIjoiQ0hOX0VORyIsInJlY29nbml6ZV9ncmFudWxhcml0eSI6ImJpZyJ9fQ==",
            }
        ]
    }
}

• 成功响应示例

  HTTP/1.1 200 OK
  Date: Thu, 22 Jun 2017 07:30:56 GMT
  Content-Type: application/json; charset=utf-8
  Content-Length: 237
  Connection: keep-alive
  Server: BceBos
  x-bce-debug-id: MTAuNzUuNzguNDA6VGh1LCAyMiBKdW4gMjAxNyAxNTozMDo1NiBDU1Q6MTg1MDY5NDg3OQ==
  x-bce-request-id: 598f7e18-77fb-424a-bc68-95acb0644076
  
  {
  	"result" : {
  		"antiporn" : {
  			"result" : [{
  					"probability" : 0.000071,
  					"class_name" : "色情"
  				}, {
  					"probability" : 0.000291,
  					"class_name" : "性感"
  				}, {
  					"probability" : 0.999638,
  					"class_name" : "正常"
  				}
  			],
  			"log_id" : 1853911322,
  			"result_num" : 3
  		},
  		"ocr" : {
  			"log_id" : 2471272194,
  			"words_result_num" : 2,
  			"words_result" : [{
  					"words" : " TSINGTAO"
  				}, {
  					"words" : "青島"
  				}
  			]
  		}
  	},
  	"log_id" : 149811665151162
  }

• 失败返回示例

  {
      "log_id": 149319909347709,
      "error_code": 216500,
      "error_msg": "unknown error"
  }

  失败error_code解释：

  错误码	错误信息	描述
  216101	not enough param	参数不足
  216102	service not support	输入了不支持的底层服务类型
  216200	empty imge	没有图片 Url
  216500	unknown error	未知错误
  282804	download image error	图片下载失败
  282000	logic internal error	业务逻辑层错误