本文介绍了如何使用云盾内容安全服务提供的内容检测API SDK。在使用SDK前,您需要阅读内容检测API文档,了解各个接口的具体功能。

开发准备

  • 准备各语言SDK依赖的开发环境。
    访问 阿里云开发工具包(SDK),选择您的开发语言,下载并准备阿里云内容检测API(阿里绿网)SDK的依赖环境。

  • 内容检测API(阿里绿网) SDK 支持以下语言或环境:
  • 下载SDK使用代码示例。

    单击下载 green-sdk-sample_doc

    上述代码示例里面包含完整的JAVA、PHP、Python调用示例,供您参考。

  • 参考第三方SDK。
    如果您使用除Java、PHP、Python以外的开发语言,推荐您通过HTTP请求直接调用内容检测API;我们也收集了一些第三方开发者编写的内容安全SDK,供您参考。内容安全第三方SDK包括以下语言:c#、c++、nodejs、python(3.5)、go。具体参见其他语言 SDK
    说明
    对第三方SDK,阿里云不提供后续维护,只作列举参考。

SDK说明

  • 在SDK实现上,智能鉴黄、OCR图片识别封装成一个接口,即图片检测SDK接口,并提供以下两种调用方式:
    • 图片同步检测接口:只支持对单张图片进行检测,直接返回图片检测结果。
    • 图片异步检测接口:支持对批量图片进行检测,接口将针对每一张图片返回一个taskId,您需要在1分钟后,通过taskId获取检测结果。
  • 图片检测接口支持多种场景,如智能鉴黄、OCR图片识别等;您也可以在一次调用中针对多个场景同时进行检测,只需要在调用接口时传递多个场景参数即可。

    例如,在场景参数中包含porn和ocr,就可以对目标图片同时进行智能鉴黄和OCR图文识别。

使用限制

  • 支持以下图片链接协议:HTTP和HTTPS。
  • 支持以下图片格式:PNG,JPG,JPEG,BMP,GIF。
  • 同步调用时,图片大小限制为5M以内;异步调用时,图片大小限制为20M以内,下载时间限制为3s以内。
  • 图片像素建议不小于256*256,太小可能会影响识别效果。
  • 图片检测接口响应时间依赖图片的下载时间。请保证被检测图片所在的存储服务的稳定可靠,推荐您使用OSS存储图片,或者使用CDN做缓存。