内容检测API

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

内容安全异步接口是否支持一次任务回调多条数据?

不支持。

如何解决网页审核检测结果欠佳的情况?

目前网页审核功能不支持新用户购买,之前已经购买的用户仍然可以使用,但是该功能的检测结果欠佳。建议您考虑如下替代方案:

  • 如果您的网站采用阿里云OSS存储,可开启OSS违规检测一键式接入。具体操作,请参见OSS违规检测

  • 如果您网站中的图片/音视频等内容可以单独获取,建议接入内容审核API服务。具体信息,请参见API概览

  • 如果您只能提供网站页面URL或者网站域名,建议通过第三方网页采集服务获取网页HTML内容,接入文本审核API服务。具体信息,请参见文件异步检测1.0

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

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

如何使用内容安全人脸检索功能?

如果您初次接入人脸检索功能,建议您先按照文档进行操作。更多信息,请参见人脸检索使用概述

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

文本审核帮助您检测指定的中文或英文文本中是否包含违规信息。关于文本垃圾内容检测接口的详细描述,请参见文本同步检测

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

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

如何查询内容安全文件检测结果?

内容安全API提交文件检测任务后,您可以调用/green/file/results接口查询文件检测结果。更多信息,请参见查询文件检测结果

如何提交内容安全文件检测任务?

内容安全API提交文件检测任务,自动解析文件内容,并分别检测其中的图片和文本内容。更多信息,请参见文件异步检测1.0

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

调用内容安全API的公共返回参数和公共错误码。更多信息,请参见公共参数

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

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

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

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

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

不同检测对象需要的检测时间有差异,具体如下:

  • 图片:排除下载时间,图片检测时间一般在300毫秒左右。

  • 视频:

    • 视频文件:排除下载时间,视频文件的检测时效通常在1~6倍速。以6倍速为例,6分钟的视频需要1分钟检测完。

    • 视频流:根据截帧的频率不同,返回时效也不同。通常在截帧后的1秒内返回结果。

  • 语音:

    • 语音文件:排除下载时间,语音文件的检测时效通常在1~6倍速。以6倍速为例,6分钟的语音文件需要1分钟检测完。

    • 语音流:通常每5~10秒返回一次结果,每检测出一句完整的话返回一次。

  • 文本:通常在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调用的并发限制,请参见内容安全产品定价页的并发限制部分内容。如果您的业务需要更大的并发量,请联系客户经理申请并发扩容。

提交检测的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秒内返回结果。

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

支持。更多信息,请参见接入地址(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)和多场景(Scenes)情况下,返回不同Label?

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

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

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

调用内容安全语音审核接口,为什么回调消息中的音频切片时间超过40分钟?

内容安全语音审核时,如果通过回调消息方式获取语音检测结果,音频流会分片检测,每当检测到违规结果都会发送回调通知。 在语音全部检测完成后,会汇总全部音频分片检测的结果,并发送回调通知,其中包括检测正常的音频分片结果。更多信息,请参见语音异步检测

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

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

内容安全图片审核是否支持提交图片Base64编码?

图片审核API只支持图像URL,不支持直接传入Base64编码。如果您是对本地图片文件进行检测,强烈建议您使用阿里云对象存储OSS服务,将本地文件存储在云上存储空间,获取公网可以访问的URL后再提交内容检测。更多信息,请参见什么是对象存储OSS

为什么在返回结果中没有内容安全文本检测表情符号(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

网页检测接口为什么没有返回imageResults字段?

网页检测是根据HTML网页中img标签中的src地址提取图片,地址需要是http://或者https://开头的URL。您可以查看网页源代码,搜索<img,判断src标签是否为http://或https://开头的URL(JS代码中的不统计)。如果没有,则不返回imageResults信息。

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

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

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

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

内容安全的人脸比对,是否支持其他国家的人脸呢?

支持。更多内容,请参见人脸比对API

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

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

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

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

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

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

停止调用接口后会停止任务,但还会有一些数据在回调,一般不会延迟太久。

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

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

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

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