本文汇总了使用内容检测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.XX.XX/8
  • 100.64.0.0/10
  • 172.16.0.0/12
  • 192.168.0.0/16
  • 127.0.0.1/32
  • 33.0.XX.XX/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地址是否能打开。如果是视频截帧检测，截帧序列中的部分图片可能无法正常下载，建议检查截帧相关的参数，比如时间参数等是否正确。如果是视频流检测，建议确认检测时视频流是否正在推送。

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

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

解决方法：如果是视频截帧检测，截帧序列中的部分图片可能无法正常下载，建议检查截帧相关的参数，比如时间参数等是否正确。或者通过在线服务联系我们。更多信息，请参见视频截帧。

为什么调用内容安全图片审核接口返回错误码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）？

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

解决方法：如果是偶发报错，建议重试。若持续返回该错误码，请通过在线服务联系我们，技术人员会及时排查问题。

为什么调用内容安全API返回错误码588（EXCEED_QUOTA）？

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

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

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

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

解决方法：建议检查图片或视频文件是否损坏，或者通过编解码工具测试图片或视频编解码是否正常，图片支持以下格式：PNG、JPG、JPEG、BMP、GIF、WEBP。更多信息，请参见同步检测。

为什么调用内容安全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导致的问题无法知晓具体环境，建议您自行排查。