当API请求发生错误时，服务端会返回错误信息。本文档为您介绍API返回的错误码信息。

图像分割错误码

状态码 错误码 描述
400 MissingParameter 入参缺失。
400 InvalidParameter 入参错误。
400 MissingImageURL 缺少图像URL。
400 InvalidParameter.Unsuitable 数据为空或参数无效。
400 InvalidParameter.Convert 输入参数转换失败。
400 InvalidParameter.Transfer 下载或上传数据失败。
400 InvalidImage.Download 图片下载失败。
400 InvalidTimeStamp.Expired 用户时间和服务器时间差异超过15分钟，请检查您的时间戳设置，确保时间戳和服务器时间的差值在15分钟内。
400 SignatureDoesNotMatch 签名不匹配。请检查AccessKeyID和AccessKeySecret是否正确；检查签名方法是否正确。详细信息请参见请求签名。
400 InvalidImage.Content 输入图像内容不合法。例如：
  • 输入的image是空字符串。
  • 无效的base64编码图像。
  • 无效的image content。
400 InvalidImage.Resolution 图片分辨率不符合要求。您可以在对应API的图片限制中查看图片分辨率限制。
400 InvalidImage.URL 无效的图片URL。
400 IllegalUrlParameter URL不合法。
400 InvalidImage.Unsafe URL不安全。
400 InvalidImage.Content 图像内容不正确。
400 InvalidImage.Region 图片所在地域错误。
400 SignatureNonceUsed SignatureNonce重复。每次请求的SignatureNonce在15分钟内不能重复。
400 Throttling.User 该时段流量已经超限。如果不能满足现有业务要求请提工单申请。
400 InvalidParameter.TooLarge 待检测内容过大，请确保待检测的内容在API的限制范围内。
403 InvalidApi.NotPurchase 服务未开通，请先开通服务。具体请参见开通视觉智能开放平台服务。
403 Unauthorized 权限不足，请先进行授权操作。具体请参见使用RAM Policy控制访问权限。
403 ParameterError 参数错误，请对参数进行检查。
404 InvalidAccessKeyId.NotFound AccessKeyID找不到。请检查调用时是否使用了正确的AccessKey。具体请参见创建AccessKey。
408 Timeout 请求超时。
500 InternalError 调用算法服务出错。
500 InternalError.Env 初始化环境失败。
500 InternalError.Model 模型加载错误。
500 InternalError.Algo 算法服务出错。

公共错误码

API的公共错误码请参见API错误中心。

处理建议

请求服务出现错误码提示，请参见错误码描述查看具体错误原因，并进行错误处理。针对一些常见高频的错误类型，此处提供一些错误处理建议供您参考。
  • URL类错误码

    此类错误码一般都是图片URL不符合要求，例如URL不安全、无效等。建议确认当前URL是否正确，或者您可以重新生成新的URL，具体请参见生成URL。

  • 图像加载错误码

    此类错误也可以看做是图像URL错误，例如图像下载错误、地域错误等。当前我们仅支持华东2（上海）地域，如果您通过OSS生成URL，那么您在OSS上创建的Bucket所属地域应该为华东2（上海）。

  • 参数类错误码

    此类错误码一般是输入参数不符合要求，例如参数缺失、参数类型错误等。建议您检查输入参数是否符合要求，您可以参考对应API文档中的请求参数表格进行检查确认。

  • 系统服务类错误码

    如果出现此类错误码，建议您重新发起服务请求，如果问题依然存在，请在钉钉群组（32665857）中反馈问题。