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

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

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

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

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

关于内容检测API调用的并发限制,请参见内容安全产品定价页的并发限制部分内容。如果您的业务需要更大的并发量,请提交工单联系我们。

内容检测API的免费试用次数如何计算?

从您首次调用某个场景(scene)进行检测的当日起,该检测场景每天有固定额度的免费检测量,持续一个月。不同检测场景的免费检测量独立计算。

关于不同检测场景支持的免费检测量,请参见内容安全产品定价

示例:假设您在2020年1月1日第一次调用图片鉴黄场景(scene为porn),则接下来的一个月(截止2020年1月31日),您每天调用的前3000张图片鉴黄检测都不收费,超过3000张的调用会收费;到2020年2月1日以后,所有图片鉴黄检测都会收费。同理,假设您在2020年1月15日首次调用OCR图文识别(scene为ocr),则在1月15日到2月14日之间,您每天调用的前3000张图片OCR识别都不收费,超过3000张的会收费;到2020年2月15日以后,所有图片OCR识别都会收费。

已购买内容安全基础包,如何修改其规格?

已购买的内容安全基础包只支持升级规格,不支持降低规格。您可以在阿里云控制台用户中心中处理。具体操作请参见包年包月基础包

同步检测和异步检测有什么区别?

  • 同步检测会在同一个调用请求中实时返回检测结果,是图像和文本检测的常用方式。您的业务可以在提交完同步检测任务后,等待服务器返回结果,然后再继续其他的业务逻辑。
  • 异步检测通常不会立即返回内容的检测结果,需要您主动轮询检测结果或者设置回调接口后让服务端主动将检测完成的消息推送给您,是视频和语音检测的常用方式。您的业务可以在提交完异步检测任务后,立即处理其他的业务逻辑,不用等待服务端返回结果。

内容检测后发现违规,是否可以保留违规证据?

可以。您可以使用以下方式保留检测结果:
  • 根据服务端返回的结果,自行判断是否需要将结果保存到本地或者云上。如需保留,您需要手动操作。
  • 针对视频和语音检测,内容安全结合对象存储OSS服务,可以帮助您自动将违规的证据转存到您的OSS存储空间。使用该功能将产生OSS存储费用。更多信息,请参见证据转存

没有公网URL的本地图片文件、视频文件、语音文件,以及二进制的文件流,如何进行内容检测?

强烈建议您使用阿里云对象存储OSS服务,将本地文件存储在云上存储空间,获取公网可以访问的URL后再提交内容检测。更多信息,请参见什么是对象存储OSS

提交检测的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概览
说明 随着服务升级,调用示例的版本日期会发生变化,请定期关注官方文档。

您也可以访问内容安全功能体验页,进行可视化测试。

同步调用OCR图文检测时报错“AlgorithmTimeOut”,如何处理?

”AlgorithmTimeOut”报错表示检测超时。OCR图文识别比较耗时,使用同步调用接口时,系统默认设置了3秒的超时限制。建议您在图片文字比较少的场景下使用同步调用,如果图片中文字比较多,出现超时的概率也会比较大。

如果您的业务场景下图片中文字比较多,建议您调用异步OCR图文识别接口,系统会增加重试次数并执行更多优化处理,将不会出现超时问题。更多信息,请参见异步检测

接口调用后返回400错误(msg: the request is expired),如何处理?

接口返回400错误一般是因为请求参数不正确。建议您检查一下API接口中的参数是否按照规范传递。

已开通内容安全,但接口调用后报错“Your using subaccount is not authorized”,如何处理?

上述错误表示发起调用的RAM用户账号没有权限。建议您使用主账号完成相关授权。更多信息,请参见子账号接入

本地测试时报错“Speicified endpoint or uri is not valid”,如何处理?

上述报错表示缺少对应语言的依赖或者aliyun-**-sdk-core版本过低,建议您参照SDK参考中提供的代码示例进行调用。更多信息,请参见SDK概览

本地测试正常,但是发布到ECS时报错“SDK.ServerUnreachable: Speicified endpoint or uri is not valid”,如何处理?

上述报错表示ECS实例未设置公网外联,而内容检测API需要通过公网访问。请提交工单联系ECS技术支持团队进行咨询。