阿里云图像识别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业务逻辑层错误。