一、接口报错了,但是没有返回 RequestId 是什么原因?
·域名被防火墙或路由器阻止:检查防火墙和路由器设置,确保不会阻止对该域名的 ping 请求。
·DNS 解析问题:如果机器无法解析该域名的 IP 地址,则无法 ping 通。尝试使用其他 DNS 服务器进行解析或清除 DNS 缓存。
·ICMP 协议被阻止:如果远程服务器禁用了 ICMP 协议,机器将无法 ping 通它。
二、SDK 抛出异常 java.net.SocketTimeoutException: connect timed out,该怎么解决?
java.net.SocketTimeoutException 是一个网络异常,通常表示客户端和服务器之间的连接在等待数据时超时了。
在使用 OkHttp 时,如果你正在遇到此异常,则可能是由于请求超时导致的。你可以通过以下方法解决此问题:
·调整 OkHttp 的超时时间:图片审核服务超时时间是15s,你可以通过调整 OkHttp 的超时时间来解决该问题,可以通过以下代码实现:
OkHttpClient client = new OkHttpClient.Builder() .connectTimeout(10, TimeUnit.SECONDS) .writeTimeout(10, TimeUnit.SECONDS) .readTimeout(30, TimeUnit.SECONDS) .build();
·尝试重新发送请求:如果调整 OkHttp 的超时时间不起作用,你可以尝试重新发送请求。
每个 SDK 的目录下也有设置超时时间的示例,以 Java SDK 为例,其他语言参考对应 SDK。
三、调用 API 报错 ImageDownloadError 该如何处理?
ImageDownloadError 是提示图片下载失败了,导致的原因有以下几点:
·图片无法访问,本地 wget 下载返回404、405无法建立 SSL 连接等错误。
·图片存储地址有防盗链、访问白名单等限制,解决办法为
·放通图片域名 https://ims.tencentcloudapi.com
·放通图片服务的 UA(User-Agent):Server/CMS
·进行图片下载 IP 加白,可以 提交工单 联系我们获取
·图片下载耗时太高,图片审核服务目前下载超时设置时间是3s,超时会重试一次,两次都超时返回下载失败报错。一般下载耗时高可能原因为用户侧图片 CDN 有网络波动,会导致图片下载服务耗时过高。
·如果使用的 COS 链接,目前 COS 链接的域名格式只支持 xxx.cos.myqcloud.com 类型。
·图片状态不完整,送审图片源链接存在根据 URL 进行 resize 裁剪情况,导致审核服务在下载图片的同时,图片正在裁剪,出现下载失败。
如果没有以上问题,可以 提交工单 联系我们,并提供接口返回的 RequestId 便于我们排查。
四、调用 API 报错 InvalidImageContent 该如何处理?
提示图片内容错误,处理文件出问题了,导致原因有以下几点:
·送审的不是图片链接,可能是音频、视频或者网址。
·URL 无法打开。
·URL 链接有缺漏,如只传了路径或者链接里缺少 HTTP 协议头。
·送审的内网链接,目前内网链接不支持审核。
·图片解码失败,可通过打开链接查看图片是否有破损或者图片内容有问题。
·图片尺寸太大,目前尺寸限制最大9999*9999。
如果没有以上问题,可以 提交工单 联系我们,并提供接口返回的 RequestId 便于我们排查。
五、调用 API 报错 InvalidFileContentSize 该如何处理?
提示文件大小超限,请求 FileUrl 的图片大小超过5MB,会报该错误信息,如果送审的是 FileContent,由于云 API 会限制请求包的大小10MB,则会提示如下错误。
{ "Response": { "Error": { "Code": "RequestSizeLimitExceeded", "Message": "Your current request size exceed max 10485760B, but your 13993388B." }, "RequestId": "456cd23f-27d3-47ec-846d-da8e0919dbc2" }}
六、调用 API 报错 ImageSizeTooSmall 该如何处理?
·提示图片分辨率过低,分辨率最低支持200 × 200。
·图片文件大小过小,文件大小最小不小于256字节。
七、调用 API 报错 InvalidContent 该如何处理?
·请求传参中,FileUrl 和 FileContent 都为空。
·FileContent 传参 base64 异常导致解码失败。
八、调用 API 报错 RequestLimitExceeded 该如何处理?
提示接口请求超频,默认是100QPS,错误量较少建议通过控制并发来避免平滑送审,如果持续出现超频错误且稳定当前量级,可以通过商务联系专员评估资源和费用。
九、SSL 证书是否可忽略?
可以忽略,如果通过 SDK 接入,现网不需要关闭证书校验。现网的证书都是付费购买的被信任的证书。如果还报证书错误,需要检查你环境上的 openssl 版本以及证书文件是否正确。