对象存储BOS

    接口描述

    接口描述

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

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

    请求

    • 请求语法

        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 业务逻辑层错误
    上一篇
    分片上传相关接口
    下一篇
    通用文字识别(ocr)