阿里云图像识别api接口

阿里云图像识别api接口API接口,此接口用于请求图像审核服务。

说明:使用本接口需要先在控制台开通图像审核服务。

请求

  • 请求语法

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

  • 成功响应示例

    HTTP/1.1 200 OKDate: Thu, 22 Jun 2017 07:30:56 GMTContent-Type: application/json; charset=utf-8Content-Length: 237Connection: keep-aliveServer: BceBosx-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解释:

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