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

关于调用API的常见问题,请参见内容检测API

为什么调用API时提示:You have not opened Yundun Content Moderation Service?

报错原因:没有开通内容安全服务。

解决办法:登录内容安全服务开通页面先开通服务,然后再调用API。

为什么本地测试正常,但是发布到ECS时报错:SDK.ServerUnreachable: Speicified endpoint or uri is not valid?

报错原因:ECS实例未配置公网访问权限,而内容检测API需要通过公网访问。

解决方法:配置公网访问权限,确保能访问到ECS上。首先,您需要通过Ping对应环境的接入地址(Endpoint)来查看网络环境的连接情况,如果网络环境正常,请检查是否缺少对应语言的依赖或者aliyun-**-sdk-core版本过低,建议您参照SDK参考中提供的代码示例进行调用。

更多信息,请参见SDK概览

为什么使用内容安全SDK报错:SDK.ServerUnreachable : SocketTimeoutException has occurred on a socket read or accept?

报错原因:网络访问异常,内容安全API需要通过公网访问。

解决方法:配置公网访问权限,确保能访问到ECS上。需要自查网络环境,可以自行Ping对应环境的Endpoint来验证。如果网络环境正常,请检查是否缺少对应语言的依赖或者aliyun-**-sdk-core版本过低,建议您参照SDK参考中提供的代码示例进行调用。

更多信息,请参见SDK概览

为什么调用API时提示:algo failed(ocridcard-modelnotexist)?

报错原因:当前使用的接入地址(Endpoint)所在地域不支持OCR卡证模型(ocridcard-model)。

解决方法:选择其他支持该功能地域的接入地址。

更多信息,请参见接入地址(Endpoint)

为什么调用API时提示:Your using subaccount is not authorized, please refer to the page?

报错原因:RAM用户没有授权。

解决方法:内容检测API支持您通过RAM用户的方式进行调用。使用RAM用户方式时,您需要先创建RAM用户并完成授权。

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

为什么调用API时返回错误码401(NOT_ALLOWED)?

报错原因:一般是由于您使用了不安全的图片、视频、语音链接地址。

解决方法:请检查您的链接地址是否安全,或者排查您的IP地址是否在如下内网网段中(内容安全服务需要使用公网IP):
  • 10.0.0.0/8
  • 11.0.0.0/8
  • 100.64.0.0/10
  • 172.16.0.0/12
  • 192.168.0.0/16
  • 127.0.0.1/32
  • 33.0.0.0/8

为什么调用API时返回错误码400(BAD_REQUEST)?

报错原因:一般是由于请求参数不正确导致,请仔细检查请求参数。如果错误信息是[task.url] is bad format,表示URL地址有误。

解决方法:建议您检查一下API接口中的参数是否按照规范传递。如果提示URL地址有误,请您自查URL地址。如果浏览器能打开,请排查URL中是否存在特殊字符,如果存在,需要对特殊字符需要Encode编码。

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

为什么调用API时返回错误码594(EXPIRED)?

报错原因:因为任务TaskID过期导致的。比如图片审核异步检测结果查询接口,对于TaskID 24小时之内的查询取结果生效,超过24小时就返回EXPIRED

解决方法:提交异步检测任务后,建议您将查询结果间隔设置为30秒,避免TaskID过期。

为什么调用API时返回错误码596(PERMISSION_DENY)?

报错原因:因为账号未授权、账号欠费、账号未开通、账号被禁等原因,具体请参考返回的错误信息。

解决方法:请检查调用账号是否已授权或欠费。如果您使用RAM用户调用内容安全,需要对RAM用户授权;如果您尚未开通内容安全,请先登录内容安全服务开通页面先开通服务。

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

为什么调用OCR识别同步检测时报错:AlgorithmTimeOut或者图片发生文字截断情况?

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

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

为什么调用API时返回错误码592(DOWNLOAD_TIMEOUT)?

报错原因:表示下载超时。下载时间限制为3秒,请确保检测的内容大小在API的限制范围内。

解决方法:建议检查图片链接是否可访问或图片下载时间是否在3秒内。如果是CDN图片地址,有可能是因为CDN回源后导致下载超时,建议不使用CDN链接。如果是跨区域的访问,比如新加坡的服务请求美西OSS地址,很容易会超时,建议切换到服务区域内的OSS地址。

为什么调用内容安全文本审核接口报错: [task.dataId] is too long(>256)?

报错原因:DataId超过128个字符。DataId是用于唯一标识您的业务数据,由大小写英文字母、数字、下划线(_)、短划线(-)、英文句号(.)组成,比如DataId为cfd33235-71a4-468b-8137-a5ffe323a7e8

解决方法:根据接口文档调整DataId的传入参数。

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

为什么使用HTTP方式调用API,提示签名出错:Status Code: 400?

报错原因:HTTP调用的签名机制较为复杂,如果自行构建签名方法容易出现代码错误。

解决方法:建议您直接使用内容安全SDK,SDK中已经封装了签名过程,无需您再编写签名代码。如果您只能使用HTTP方式调用接口,建议先查看内容安全签名机制。

更多信息,请参见SDK概览签名机制

已经将*.aliyuncs.com加入防盗链白名单,为什么使用OSS违规检测时仍然返回错误码403(Forbidden)?

报错原因:OSS存储空间无权限访问。

解决方法:OSS违规检测只向开通了阿里云对象存储OSS服务的用户提供服务。在使用OSS违规检测前,您需要为内容安全授予访问OSS存储空间的权限。

更多信息,请参见授权内容安全访问OSS存储空间

为什么调用API时返回错误码480(DOWNLOAD_FAILED)?

报错原因:表示下载失败,可能由于待检测的URL无法访问或下载,待检测内容大小和分辨率等超过限制。

解决方法:如果是图片审核,请确认下图片URL地址是否能打开。如果是视频截帧检测,截帧序列中的部分图片可能无法正常下载,建议检查截帧相关的参数,比如时间参数等是否正确。如果是视频流检测,建议确认检测时视频流是否正在推送。您也可以提交OSS工单进行问题排查。

为什么调用内容安全视频同步检测接口,部分链接一直返回错误码480?

报错原因:表示下载失败,可能由于待检测的URL无法访问或下载,待检测内容大小和分辨率等超过限制。

解决方法:如果是视频截帧检测,截帧序列中的部分图片可能无法正常下载,建议检查截帧相关的参数,比如时间参数等是否正确。或者提交OSS工单进行问题排查。

更多信息,请参见视频截帧

为什么调用内容安全图片审核接口返回错误码480(GIF_TOO_MUCH_PIXELS)?

报错原因:表示下载失败,错误信息GIF_TOO_MUCH_PIXELS提示待检测内容大小和分辨率等超过限制。

解决方法:图片审核支持的图片大小限制为20 MB以内,高度或者宽度不能超过30,000像素(px),且图像总像素不超过2.5亿px。如果待检测图片超过大小或者分辨率较高,请先进行图像压缩后再提交检测。

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

为什么调用内容安全视频直播流审核接口返回错误码480(Input/output error)?

报错原因:表示下载失败,错误信息Input/output error一般是流媒体文件问题,由于待检测的URL地址无法访问或下载。

解决方法:如果是视频流检测,建议确认检测时视频流是否正在推送,视频直播是否已经停止。如果是视频截帧检测,截帧序列中的部分图片可能无法正常下载,建议检查截帧相关的参数,比如时间参数等是否正确。

为什么调用API时返回错误码500(GENERAL_ERROR)?

报错原因:一般是服务端临时出错,需要根据返回的错误信息来具体定位问题。

解决方法:如果是偶发报错,建议重试,若持续返回该错误码,请通过工单联系我们,并提供具体返回的错误信息,技术人员会及时排查问题。

为什么使用内容安全SDK返回错误码500(service interrupted)?

报错原因:一般是服务端临时出错,错误信息service interrupted可能是因为使用的SDK与服务端版本不兼容导致。

解决方法:建议检查调用的SDK版本是否是最新的,如果是旧版本SDK建议先升级。

更多信息,请参见安装

为什么调用音频检测API报错500(failed to convert to pcm)?

报错原因:一般是服务端临时出错,错误信息failed to convert to pcm可能是因为语音流转码或者拉流失败导致。

解决方法:建议检查语音流是否正常推送,可以使用ffmpeg等工具进行音频流编解码测试,支持的语音流协议:HTTP、RTMP、RTSP。

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

为什么调用内容安全服务API返回错误码586(ALGO_FAILED)?

报错原因:算法服务出错,通常是由于算法服务的网络抖动引起超时导致。

解决方法:如果是偶发报错,建议重试。若持续返回该错误码,请通过工单提供具体返回的错误信息,技术人员会及时排查问题。

为什么调用内容安全图片检测接口时返回错误码586?

报错原因:算法服务出错,如果是特定图片或视频才报错,可能是编解码失败导致。

解决方法:建议检查图片或视频文件是否损坏,或者通过编解码工具测试图片或视频编解码是否正常,图片支持以下格式:PNG、JPG、JPEG、BMP、GIF、WEBP。

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

为什么调用内容安全API返回错误码588(EXCEED_QUOTA)?

报错原因:请求频率超出并发配额。默认并发:图片检测50张/秒,视频检测20路/秒,语音检测20路/秒,文本检测100条/秒。

解决方法:建议降低请求频率,对待检测内容进行排队处理。或者根据业务情况评估您峰值并发量,请联系客户经理申请并发扩容,或者提交并发调整申请

关于扩容的详细费用,请参见定价页面

为什么调用内容安全API提示:InvalidTimeStamp.Expired?

报错原因:调用接口的时间戳已过期,如果客户端的时间戳和服务端的时间戳相隔超过15分钟,调用时会报如上错误。

解决方法:建议您检查近期服务器时间是否有过较大变动,或者客户端机器的时区是否一致。

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

为什么登录后长时间没有使用,但是控制台自助审核报错?

报错原因:控制台访问报错,根据具体错误信息不同,可能是因为登录Session已经失效,导致访问授权失败。

解决方法:如果报错Request ID,建议您先尝试刷新浏览器,再次尝试登录控制台。如果正常登录时一直报错,请通过工单联系我们,并提供具体错误信息或截图,技术人员会及时排查问题。

为什么使用内容安全文本接口SDK,检测字符串有HTML代码标签,但是没有返回数据?

报错原因:检测字符串中含有HTML等代码标签,会被防火墙判定为风险代码注入行为,网络请求会被阻拦,导致无请求响应返回。

解决方法:建议使用文本检测时,检测内容先过滤掉网页代码标签,比如HTML代码或者SQL代码的字符,避免被防火墙拦截。

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

为什么在早上9:00前和晚上21:00后,调用内容安全OCR接口报错:Specified time stamp or date value is expired?

报错原因:调用接口的时间戳已过期,如果客户端的时间戳和服务端的时间戳相隔超过15分钟,调用时会报如上错误。

解决方法:建议您使用官网提供的SDK来发起调用,内容安全SDK支持JAVA、Python、PHP等语言。如果只能使用HTTP方式,请检查近期服务器时间是否有过较大变动,或者客户端机器的时区是否一致。

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

为什么OSS白名单调整为http://*.aliyuncs.com,增加AliyunOSSReadOnlyAccess权限后,调用图片审核API返回错误码403?

报错原因:使用内容安全API的视频和图片审核接口,来检测OSS中的文件,需要生成公网可访问的OSS链接。

解决方法:建议生成临时图片链接再调用内容安全,不支持OSS授权方式访问。 如果不能生成公网可访问的OSS链接,建议使用OSS违规检测功能,为内容安全授予访问OSS存储空间的权限后即可检测。

更多信息,请参见OSS违规检测

为什么调用内容安全API返回错误码406?

报错原因:可能是由于SDK版本不一致导致,比如使用了新版本的代码调用,但引用的是老版本SDK。

解决方法:建议检查引用的SDK版本是否最新,如果是Java SDK,引用的Core和Green包都升级到最新版,内容安全SDK支持Java、Python、PHP等语言。

更多信息,请参见SDK概览

为什么调用自定义文本库配置管理接口报错:The API is invalid?

报错原因:自定义文本库这类配置管理类接口接入地址只支持cn-shanghai,不支持cn-beijing,这个请求是获取站点检测功能的文本库列表,如果您并没有创建站点文本库,接口没有返回数据。

解决方法:管理接口使用接入地址cn-shanghai

更多信息,请参见创建文本库

内容安全图片接口返回错误码400(please contact us to open human audit service)?

报错原因:内容安全返回错误代码400,通常由于请求参数不正确导致,请仔细检查请求参数。该错误是由于没有开通人工审核服务导致。

解决方法:图片审核机审接口是/green/image/scan,请您先确认需要使用机审服务还是人工审核服务。如果您需要使用人工审核服务,请先开通服务,我们会有运营人员和您联系沟通审核标准。

关于开通服务的链接,请参见人工审核开通页

内容安全Python SDK在jupyter notebook或者命令行直接运行时报错:UnicodeEncodeError?

报错原因:UnicodeEncodeError是由于IDE导致的错误,具体原因需要检查IDE环境。

解决方法:Python SDK建议您使用主流IDE环境运行,比如PyCharm。由于IDE导致的问题无法知晓具体环境,建议您自行排查。