本文汇总了内容检测API的常见问题。

查询内容安全API的调用数据统计?

内容安全控制台汇总了内容检测API的调用统计数据,支持查询最近1年内图片、视频、文本检测接口的调用次数。

更多信息,请参见数据统计

哪个接口可以进行内容安全文本垃圾检测?

文本审核帮助您检测指定的中文或英文文本中是否包含违规信息。

关于文本垃圾内容检测接口的详细描述,请参见文本同步检测

如何反馈内容安全文本检测内容误报?

如果您审核发现内容安全文本检测的检测结果有误,您可以通过该API向我们反馈。

更多信息,请参见文本检测内容反馈

如何查看内容安全API返回结果的参数说明?

调用内容安全API的公共返回参数和公共错误码。

更多信息,请参见公共参数

内容安全API签名信息是否支持放在Body中?

签名信息只支持通过HTTP头Authorization中的Signature传入检验,也就是说签名必须在Header里面。建议您使用内容安全SDK,支持Java、Python、PHP等语言。

更多信息,请参见公共参数SDK概览

文本检测是否能检测出文本中链接地址违规?

内容安全检测文本中,目前只能检测出文本内容是否违规,暂时无法检测出文本中的URL链接是否存在违规。

内容检测API的检测时间一般需要多久?

不同检测对象需要的检测时间有差异,具体如下:
  • 图片:排除下载时间,图片检测时间一般在300毫秒左右。
  • 视频:
    • 视频文件:排除下载时间,视频文件的检测时效通常在1~6倍速。以6倍速为例,6分钟的视频需要1分钟检测完。
    • 视频流:根据截帧的频率不同,返回时效也不同。通常在截帧后的1秒内返回结果。
  • 文本:通常在50毫秒内返回检测结果。

内容安全PHP SDK可以使用Composer下载吗?

只要配置的Composer支持PHP 5.3以上的版本就可以使用,但是目前没有Composer的安装教程。

关于如何安装内容PHP SDK,请参见安装

内容安全文本审核支持英文吗?

支持英文审核。

更多信息,请参见文本同步检测

内容安全是否可以审核大于2 GB的视频?

内容安全视频审核,单个视频大小不超过200 MB(系统默认值),最大支持2 GB(超过200 MB的需要联系技术人员帮您调整)。如果您要审核超过2 GB的视频,建议对视频进行分片处理,分成多个视频后进行审核。 视频截帧默认200帧,审核大视频,如果要求更高的帧数,需要配置MaxFrames,默认最高支持3600。

更多信息,请参见异步检测

内容安全使用API访问需要什么授权?如何授权?

内容安全API支持使用RAM用户的AccessKeyID和AccessKeySecret,调用前需要授权RAM用户。

更多信息,请参见使用RAM用户调用内容安全API

内容安全图片审核支持的图片大小限制?

内容安全图片审核要求图片大小限制为20 MB以内(含20 MB),高度或者宽度不能超过30,000像素,且图像总像素不超过2.5亿。

更多内容,请参见同步检测

内容检测API调用有哪些并发限制?

并发限制指同一时刻能够检测的内容(图片、视频、文本)数量,该限制对使用流量包和后付费方式均有效。

下表描述了内容检测API对不同检测媒介的并发限制。
检测媒介 默认并发 并发单位 说明
图片 50 每秒检测的图片张数
视频 20 同一时刻进行检测的视频数(不区分文件和流)
文本 100 每秒检测的文本条数(单条文本长度小于200个字符)
说明
  • 默认并发为免费提供。如果您要调整默认并发限制,请提交工单联系我们。提高默认并发限制需另行收费。
  • 默认情况下,针对同一对象进行多场景检测只计作一次并发。例如,对同一张图片进行色情和暴恐涉政检测,则并发数量计作一。

提交检测的URL可以使用内网地址吗?

不可以。提交检测的URL必须是公网可以访问的地址。如果您担心被检测内容有泄露风险,建议您将URL的访问有效期设置短一点,例如10分钟。

如果待检测图片的大小超过了图片限制,如何进行检测?

建议您将源图片压缩后再提交检测。图片分辨率大于256*256的情况下,分辨率对识别效果的影响很小。

是否可以自己构建HTTP请求调用内容检测API?

可以。理论上您可以自己构建HTTP请求调用内容检测API,但是自己构建调用请求需要做一系列签名加密处理,因此建议您使用官网提供的SDK来发起调用。

内容检测API支持通过RAM用户的AccessKey发起调用吗?

  • V20160621及后续版本均支持通过RAM用户AccessKey发起调用。关于需要的依赖,请参见SDK概览
  • V20160621以前版本不支持。如果您使用RAM用户AccessKey调用V20160621以前版本的API,系统将返回AccessDenied错误。

内容检测API有调用示例吗?

有的。您可以在SDK参考中进行下载。更多信息,请参见SDK概览
说明 随着服务升级,调用示例的版本日期会发生变化,请定期关注官方文档。

内容安全API是否支持.NET?

不支持。建议您使用其他语言的SDK,或者自己构建HTTP请求调用内容检测API。

更多信息,请参见SDK概览请求结构

内容安全图片审核能否支持GIF图?

支持。内容安全图片审核支持以下图片格式:PNG、JPG、JPEG、BMP、GIF、WEBP。

更多内容,请参见同步检测

内容安全API下载时间限制3秒,是否支持延长时间吗?

不支持。如果频繁出现下载错误,请检查图片链接是否可访问或图片下载时间是否在3秒内。可根据服务器所在区域就近选择Region,调用链路耗时更低。

更多内容,请参见接入地址(Endpoint)

内容安全API同步检测调用一次最多可支持多少图片?

内容安全图片审核同步接口一次调用最多支持100个检测元素,即每次提交100条内容进行检测。但是支持100个元素的前提是需要将并发调整到100以上,内容安全API默认并发是:图片审核50张,文本审核100条,视频审核20路。

更多信息,请参见同步检测产品定价

内容安全API是否支持一次调用检测多个场景,例如同时进行鉴黄和暴恐检测?

内容安全API支持一次调用多个场景检测,请求参数Scenes指定多个场景,例如,[“porn”, “terrorism”] 表示对图片同时进行智能鉴黄和暴恐检测。需要注意同时检测多个场景的情况下,将按照每个场景的检测图片数量×每个场景的单价进行累加计费。

更多信息,请参见同步检测产品定价

内容安全API接口的域名和端口是多少?

如果您需要配置网络安全策略,建议用户允许域名*.aliyuncs.com,端口开放80和443。

内容安全视频审核API如何引用阿里云视频点播业务中上传的视频?

视频审核API无法直接使用视频点播业务中的VideoID,您可以通过截帧方式上传图片帧序列检测,或者使用视频可访问的URL。

更多信息,请参见异步检测

内容安全视频审核是否支持M3U8类型的文件?

不支持M3U8格式文件。视频文件支持以下格式:AVIFLVMP4MPGASFWMVMOVWMARMVBRMFLASHTS

更多信息,请参见异步检测

内容安全视频异步检测时间要多久?

视频异步审核的时间,除了和检测对象的下载时间有关,不同检测对象需要的检测时间有差异:
  • 视频文件:排除下载时间,视频文件的检测时效通常在1~6倍速。以6倍速为例,6分钟的视频需要1分钟检测完。
  • 视频流:根据截帧的频率不同,返回时效也不同。通常在截帧后的1秒内返回结果。

内容安全服务是否支持调用美国地区视频检测服务?

不支持美国地区的接入Region。目前支持的区域如下所示:

  • 华东2,Region:cn-shanghai
  • 华北 2,Region:cn-beijing
  • 华南1,Region:cn-shenzhen
  • 新加坡,Region:ap-southeast-1

如果您是海外业务,建议接入新加坡区域的服务。更多信息,请参见接入地址(Endpoint)

内容安全视频检测同步和异步接口有什么区别?

视频同步检测接口只支持通过上传视频截帧图片的方式进行检测。如果您想通过上传视频URL的方式进行检测,推荐您使用视频异步检测接口。

视频异步检测接口支持检测视频文件或视频流,且视频文件支持通过上传视频截帧图片序列或视频URL的方式进行检测,异步检测任务不会实时返回检测结果,您需要通过Callback或者轮询的方式获取检测结果。

更多信息,请参见同步检测异步检测

内容安全Java SDK的图片异步检测请求是否支持Callback参数?

图片异步检测支持Callback参数。

更多信息,请参见图片审核

内容安全的BizType参数表示什么?

表示业务场景。业务场景(BizType)是为每个业务场景提供一套审核标准,建议您在使用前根据业务要求配置自定义的业务场景(BizType)。配置自定义业务场景后,您需要内容检测API的接口中传递自定义业务场景参数,检测才会按照自定义业务场景的标准进行。

更多信息,请参见自定义机审标准

内容安全一个词库可以设置多个业务场景(BizType),有什么作用?

在创建自定义词库和图库时,建议您选择词库和图库应用生效的业务场景(BizType)。 如果文本库设置BizType A,且API检测请求中传递了BizType A,则检测文本只会使用BizType为A的文本库。 其他情况下,检测文本均会使用所有已开启的文本库。

更多信息,请参见自定义文本库

使用内容安全视频异步检测接口,回调结果的Checksum值和计算的不一致?

Checksum是总和校验码,由<用户uid> + <seed> + <content>拼成字符串,通过SHA256算法生成。用户UID即阿里云账号ID,可以在阿里云控制台上查询。 内容安全回调消息防止篡改,您可以在获取到推送结果时,按上述算法生成字符串,与Checksum做一次校验。

更多信息,请参见回调通知

调用内容安全文本审核接口,为什么没有返回DataId?

内容安全文本审核API,如果在检测请求参数中传入了DataId,则返回对应的DataId

更多信息,请参见文本同步检测

调用内容安全图片审核接口,相同图片在单场景(Scene)和多场景(Scene)情况下,返回不同Label?

通常是由于多场景配置模型不一致,导致单场景(Scene)和多场景(Scene)的检测过程出现配置冲突,建议您联系算法运营确认是否场景配置存在问题,或者分开场景(Scene)对图片进行检测。

更多信息,请参见同步检测图片审核

为什么内容安全文本审核结果中没有透出风险关键词Context?

文本审核的Context字段是检测文本命中的风险关键词,如果命中了关键词会返回该内容,如果命中了算法模型或者相似文本等策略,则不会返回该字段。

更多信息,请参见文本同步检测

为什么内容安全文本审核接口返回FilteredContent,但是没有返回命中关键词Context?

内容安全文本审核的FilteredContent字段是过滤后文本内容,如果被检测文本命中了自定义关键词或相似文本等算法时,则会返回当前字段,并将命中的关键词替换为星号(*)。 而文本审核的Context字段是检测文本命中的风险关键词,如果命中了关键词会返回该内容,如果命中了算法模型或者相似文本等策略,则不会返回该字段。

更多信息,请参见文本同步检测

为什么在返回结果中没有内容安全文本检测表情符号(emoji)?

内容安全文本检测目前暂不支持表情符号emoji的识别,识别结果返回中会过滤掉表情符号的字符。

内容安全图片检测同步与异步的准确率和召回有差别吗?

图片审核同步检测和异步检测只是在API调用方式上有差别,识别效果是一样的。

为什么内容安全Java SDK本地文件和二进制数据检测ClientUploader类无法下载?

内容安全Java SDK的ClientUploader工具类需要客户自行下载并引入到项目工程中。

关于下载地址和操作步骤的介绍,请参见安装

内容安全Python SDK 3.5.4和3.8.8版本无法识别aliyunsdkcore库?

内容安全Python SDK安装建议使用3.x的主流版本,如果仍然无法安装或者识别SDK库,可以下载后进行本地工程引入。

更多信息,请参见安装

如何安装内容安全Python SDK的aliyunsdkgreenextension类?

内容安全aliyunsdkgreenextension工具类需要下载后本地工程引入。

另外,需要使用以下方式引入:
from aliyunsdkgreenextension.request.extension import HttpContentHelper

更多信息,请参见安装

内容安全自定义文本库中的关键词库支持小语种吗?

不支持。自定义词库只支持中文、字母和数字。

如果选择上传本地图片到OSS空间进行图片检测、视频检测等,那么OSS链接有效期是多久的?

OSS链接的有效期是1个小时。

内容安全视频流直播是如何计费的?

直播计费按照直播时间×截帧频率,以最终的截帧数量来计费。

例如直播时间1小时,每5秒截帧一次,共计截帧是3600秒/5秒=720。则是以720张截帧图片进行计费的。

内容安全直播流检测数据是如何回调的?

视频直播流数据会分段的,检测到违规结果才返回,直播结束后会返回总的数据。

为什么内容安全直播流检测已停止,但是还有数据在回调?

停止调用接口后会停止任务,但还会有一些数据在回调,一般不会延迟太久。如有疑问可通过工单联系我们。

内容安全直播检测,如果断流或发起任务后还没有直播流,任务是否就停止了?

直播流中断或提交检测任务后还没有视频流,导致系统未获取到视频流的情况下,则会请求视频流三次,间隔最短为10秒,如果在30秒内还未获取到视频流,则认为任务终止。

在什么情况下内容安全直播流检测code会返回200?

检测成功会返回200。直播过程中返回是280,直播结束和中断会正常返回code。