SDK概览

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

SDK使用说明

在使用SDK前,需了解各个接口的具体功能。更多信息,请参见API 概览

  • 我们将图像检测相关的功能封装成一个接口(例如图片鉴黄、图片涉政暴恐检测、图片OCR、图片Logo检测等),并提供以下两种调用方式:

    • 图片同步检测接口:支持对多张图片进行检测,同步返回所有检测结果,建议一次检测一张图片。

    • 图片异步检测接口:支持对批量图片进行检测,接口将针对每一张图片返回一个taskId,您需要在提交检测任务后,通过taskId获取检测结果,对于批量图片检测,推荐使用该方式。

  • 我们将视频检测相关的功能封装成一个接口(例如视频鉴黄、视频涉政暴恐检测、 视频Logo检测等),并提供以下两种调用方式:

    • 视频同步检测接口:只支持用户自己将视频截成图片帧序列,传递图片序列进行检测,不推荐使用该方式。

    • 视频异步检测接口:支持用户传递视频进行检测,您需要在提交检测任务后,通过taskId获取检测结果或者通过设置回调接口接收检测的结果回调通知,推荐您使用该方式进行视频内容检测。

  • 语音反垃圾:语音垃圾内容检测SDK支持语音流和语音文件的检测,目前只有异步检测接口,您需要在提交检测任务后,通过taskId获取检测结果或者通过设置回调接口接收检测的结果回调通知。

  • 文本反垃圾:文本反垃圾只有同步检测接口,您可以在一次请求中检测一条或者多条文本。

说明

在一个接口(例如图片检测)中调用多个场景进行检测时,按照“每个场景的计费单价×检测的内容量”进行计费。

开发准备

  • 内容安全SDK支持以下语言或环境:

  • 下载SDK使用代码示例。

    单击 green-sdk-sample_doc下载SDK代码示例。

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

    重要

    2018-05-09之前版本的接口已经下线,如果使用旧的版本号会返回HttpCode:400 , ErrorCode:InvalidAction.NotFound报错,如遇报错请更换为2018-05-09版本号。

  • 参考第三方SDK。

    如果您使用除Java、PHP、Python、Go、.NET以外的开发语言,推荐您通过HTTP请求直接调用内容检测API;我们也收集了一些第三方开发者编写的内容安全SDK,供您参考。内容安全第三方SDK包括以下语言:c#、c++、nodejs、python(3.5)。具体内容,请参见其他语言 SDK

    说明

    对第三方SDK,阿里云不提供后续维护,只作列举参考。

技术答疑

如果您在接入API或SDK的过程中遇到问题,可以搜索钉钉群号(35573806)加入内容安全技术答疑群。加群时请备注您的公司名称+职位类型(研发、产品或者审核),例如XXX公司+研发。