When an API request fails, the server-side returns an error message. This topic describes the error codes returned by Image Production API operations.
For questions about API integration, using operations, or other issues related to the AI capabilities of the Alibaba Cloud Visual Intelligence API, contact us in the Alibaba Cloud Visual Intelligence API consultation DingTalk group (23109592).
Troubleshoot Center
You can use the Troubleshoot Center to efficiently diagnose issues that occur when you use API operations.
Image enhancement error codes
Status code | Error code | Description |
403 | AuthFailed | Authorization failed. Check your RAM permission configuration. |
400 | ClientError.IllegalArgument | Check the parameters. For example, check whether the database represented by the parameter value exists. |
400 | EntityNotExist.Role | You do not have the required RAM permissions. Contact your Alibaba Cloud account to grant you the AliyunVIAPIFullAccess permission. For more information, see Control access permissions using RAM policies. |
400 | IllegalUrlParameter | The URL is invalid. Check whether the URL can be opened. For image URLs that are not for OSS objects in the China (Shanghai) region, see Process file URLs. |
500 | InternalError | An internal server error occurred. If your business is affected, contact us through the DingTalk group (23109592). |
500 | InternalError.Algo | An internal algorithm processing error occurred. If your business is affected, contact us through the DingTalk group (23109592). |
500 | InternalError.Remote | The remote service is unavailable. If your business is affected, contact us through the DingTalk group (23109592). |
500 | InternalError.Server | An internal system error occurred. If your business is affected, contact us through the DingTalk group (23109592). |
500 | InternalError.Timeout | The algorithm service timed out during internal processing. Retry later. If your business is affected, contact us through the DingTalk group (23109592). |
500 | InternalServerError | An internal system error occurred. If your business is affected, contact us through the DingTalk group (23109592). |
400 | InvalidAccessKeyId.Inactive | The AccessKey ID is invalid. Check whether the AccessKey ID is disabled, or whether the AccessKey ID and AccessKey secret are correct. |
404 | InvalidAccessKeyId.NotFound | The AccessKey ID does not exist. Check whether you are using the correct AccessKey for the call. For more information, see Create an AccessKey. |
400 | InvalidAccessKeySecret | The AccessKey ID or AccessKey secret is incorrect. Check whether the AccessKey ID and AccessKey secret are correct. |
404 | InvalidAction.NotFound | The API operation was not found. Check whether the API operation is correct. |
400 | InvalidApi.ForbiddenInvoke | The call is restricted. Check whether the capability you are calling is restricted. To call a restricted capability, go to the console, find the capability, and submit a request. You can call the capability after the request is approved or you manually activate the capability. If this is not the case, check whether your account has an overdue payment. |
403 | InvalidApi.NotPurchase | The service is not activated. Activate the service first. |
400 | InvalidApi.OutOfService | The product is not activated. Activate the product. |
413 | InvalidContentLength | The content length is too long. |
400 | InvalidFile.Content | Check the file content based on the algorithm document. Replace the file with one that meets the algorithm requirements. |
400 | InvalidFile.Decode | Check whether the file can be opened. |
400 | InvalidFile.Download | The file cannot be downloaded. Check your on-premises network and whether the URL is accessible. For file URLs that are not for OSS objects in the China (Shanghai) region, see Process file URLs. |
400 | InvalidFile.REGION | The region of the file URL is incorrect. For file URLs that are not for OSS objects in the China (Shanghai) region, see Process file URLs. |
400 | InvalidFile.Resolution | The file resolution exceeds the limit. Check the file resolution and content. Modify the file resolution and retry. |
400 | InvalidFile.Type | The file type is incorrect. Check the file type and use a file type supported by the algorithm. For more information, see the API document for the algorithm. Alibaba Cloud Visual Intelligence API can read a file to obtain its real file type instead of determining the type by its file extension. Checking only the file extension is not effective. For more information about how to determine and process file types, see Determine and process file types. |
400 | InvalidFile.URL | The file cannot be downloaded. Check your on-premises network and whether the URL is accessible. For file URLs that are not for OSS objects in the China (Shanghai) region, see Process file URLs. |
400 | InvalidImage.Content | Parameter error: Invalid image content. |
500 | InvalidImage.Decode | Image decoding failed. |
400 | InvalidImage.Download | The image cannot be downloaded. Check your on-premises network, whether the URL is accessible, and whether the OSS URL has expired. For image URLs that are not for OSS objects in the China (Shanghai) region, see Process file URLs. URLs do not support spaces or Chinese characters. If a URL contains these characters, URL-encode the URL before you pass it. |
404 | InvalidImage.NotFoundFace | No face was found in the image. Check whether your image contains a face or whether the face is too small. |
400 | InvalidImage.REGION | The region of the image URL is incorrect. For image URLs that are not for OSS objects in the China (Shanghai) region, see Process file URLs. |
400 | InvalidImage.Resolution | The image resolution does not meet the requirements. You can view the image resolution limits in the image restrictions section of the corresponding API document. |
400 | InvalidImage.Timeout | The image download timed out. Check your on-premises network, whether the URL is accessible, and whether the OSS URL has expired. For image URLs that are not for OSS objects in the China (Shanghai) region, see Process file URLs. |
400 | InvalidImage.Type | Parameter error: Invalid type. |
400 | InvalidImage.Unsafe | The URL is not secure. |
400 | InvalidImage.URL | The image URL is invalid. Check whether the image URL is accessible. For image URLs that are not for OSS objects in the China (Shanghai) region, see Process file URLs. For OSS URLs in the China (Shanghai) region, use standard OSS domain names. Accelerated domain names and custom domain names are not supported. |
400 | InvalidParameter | An abnormal parameter error occurred. |
400 | InvalidParameter.BadRequest | Parameter error. Check the parameter value based on the algorithm API document and the error message. For example, check whether the parameter value contains leading or trailing spaces or other special characters. |
400 | InvalidParameter.NotFound | Parameter error. Check the parameter value based on the algorithm API document and the error message. For example, check whether the parameter value contains leading or trailing spaces or other special characters. |
400 | InvalidParameter.TooLarge | The content to be detected is too large. Make sure the content is within the limits specified for the API. |
400 | InvalidRamRole | You do not have the required RAM permissions. Contact your Alibaba Cloud account to grant you the AliyunVIAPIFullAccess permission. For more information, see Control access permissions using RAM policies. |
400 | InvalidResult | Parameter error. Check the parameter values and file content based on the documentation. For example, check whether the image content is incomplete or too blurry. |
400 | InvalidSide | Specified parameter Side is not valid. Enter a correct value for the Side parameter based on the documentation. |
400 | InvalidTimeStamp.Expired | The timestamp has expired. Update the timestamp. |
400 | MissingAccessKeyId | The AccessKey ID is not specified. Check whether the AccessKey ID and AccessKey secret are correct. |
400 | MissingParameter | A required parameter is missing. Check the parameter values based on the documentation. |
403 | NeedOpen | Activate the service first. |
400 | ParameterError | Parameter error. Check the parameter values. |
403 | RamRoleAuth | Grant permissions to the role first. For more information, see Control access permissions using RAM policies. |
503 | ServiceUnavailable | The service is unavailable. If the server has returned a RequestId, contact us through the DingTalk group (23109592). |
400 | SignatureNonceUsed | The signature nonce has been used. Recalculate the signature. For more information, see Request signing. |
400 | Throttling | Throttling is triggered. For paid API operations, purchase a higher QPS. For free API operations, if you have special requirements, contact us through the DingTalk group (23109592). Note When throttling is triggered, both Throttling and Throttling.User errors may occur. Consider both when you handle the errors. |
400 | Throttling.User | The traffic for the current period exceeds the limit. For paid API operations, purchase a higher QPS. For free API operations, if you have special requirements, contact us through the DingTalk group (23109592). Note When throttling is triggered, both Throttling and Throttling.User errors may occur. Consider both when you handle the errors. |
408 | Timeout | The request timed out. |
400 | Unauthorized | You do not have the required RAM permissions. Contact your Alibaba Cloud account to grant you the AliyunVIAPIFullAccess permission. For more information, see Control access permissions using RAM policies. |
400 | SignatureDoesNotMatch | The signature is incorrect. Recalculate the signature. For more information, see Request signing. |
Common error codes
For common API error codes, see API Error Center.
Suggestions
If a service request returns an error code, refer to the error code description to determine the cause and resolve the error. The following suggestions are provided for common error types.
URL-related error codes
These errors usually indicate that the file URL does not meet the requirements. For example, the URL is insecure or invalid. For more information, see Process file URLs.
Image loading error codes
These errors are typically related to image URLs and include image download errors and region errors. We recommend that you use the China (Shanghai) region. If you generate a URL using Object Storage Service (OSS), the bucket that you create in OSS must be in the China (Shanghai) region. For more information, see Process file URLs.
Parameter-related error codes
These errors usually indicate that the input parameters do not meet the requirements. For example, a parameter is missing or has an incorrect type. You can check the request parameter table in the corresponding API document to confirm the requirements.
System service error codes
If this type of error occurs, resubmit the service request. If the problem persists, provide feedback in the DingTalk group (23109592).