本文介绍了如何使用云盾内容安全服务提供的内容检测API SDK。

SDK使用说明

在使用SDK前,您需要阅读内容检测API文档,了解各个接口的具体功能。

  • 我们将图像检测相关的功能封装成一个接口(例如图片鉴黄、图片涉政暴恐检测、图片OCR、图片Logo检测等),并提供以下两种调用方式:
    • 图片同步检测接口:支持对多张图片进行检测,同步返回所有检测结果,建议一次检测一张图片。
    • 图片异步检测接口:支持对批量图片进行检测,接口将针对每一张图片返回一个taskId,您需要在提交检测任务后,通过taskId获取检测结果,对于批量图片检测,推荐使用该方式。
  • 我们将视频检测相关的功能封装成一个接口(例如视频鉴黄、视频涉政暴恐检测、 视频Logo检测等),并提供以下两种调用方式:
    • 视频同步检测接口:只支持用户自己将视频截成图片帧序列,传递图片序列进行检测,不推荐使用该方式。
    • 视频异步检测接口:支持用户传递视频进行检测,您需要在提交检测任务后,通过taskId获取检测结果或者通过设置回调接口接收检测的结果回调通知,推荐您使用该方式进行视频内容检测。
  • 语音反垃圾:语音垃圾内容检测SDK支持语音流和语音文件的检测,目前只有异步检测接口,您需要在提交检测任务后,通过taskId获取检测结果或者通过设置回调接口接收检测的结果回调通知。
  • 文本反垃圾:文本反垃圾只有同步检测接口,您可以在一次请求中检测一条或者多条文本。
说明 在一个接口(例如图片检测)中调用多个场景进行检测时,按照“每个场景的计费单价×检测的内容量”进行计费。

开发准备

  • 准备各语言SDK依赖的开发环境。
    访问阿里云开发工具包(SDK),选择您的开发语言,下载并准备阿里云内容安全SDK的依赖环境。
    内容安全SDK
  • 内容安全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,阿里云不提供后续维护,只作列举参考。