Common error codes for video segmentation
If an API request fails, the server returns an error message. This topic describes the error codes returned by the Video Segmentation API operation.
If you have questions about API access, using API operations, or other issues related to the Alibaba Cloud Visual Intelligence API, contact us through the DingTalk group (23109592).
Troubleshooting center
You can use the Troubleshooting Center to efficiently diagnose issues that occur when you use API operations.
Video segmentation 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 a parameter value exists. |
400 | EntityNotExist.Role | You do not have 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 information about image URLs that are not for Object Storage Service (OSS) in the China (Shanghai) region, see Process file URLs. |
500 | InternalError | An internal server error occurred. If this affects your business, contact us through the DingTalk group (23109592). |
500 | InternalError.Algo | An internal algorithm processing error occurred. If this affects your business, contact us through the DingTalk group (23109592). |
500 | InternalError.Busy | The algorithm service is busy. If this affects your business, contact us through the DingTalk group (23109592). |
500 | InternalError.Model | A model loading error occurred. Try again later. If this affects your business, contact us through the DingTalk group (23109592). |
500 | InternalError.Timeout | The algorithm service timed out during internal processing. Try again later. If this affects your business, 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. |
400 | InvalidAccessKeyId.NotFound | The AccessKey ID was not found. Check whether the AccessKey ID and AccessKey secret are correct. |
400 | InvalidAccessKeySecret | The AccessKey ID or AccessKey secret is incorrect. Check whether the AccessKey ID and AccessKey secret are correct. |
400 | InvalidAction.NotFound | The capability was not found. Check whether the category and capability match, and whether the endpoint and capability match. For more information, see Endpoints. Select a programming language and modify the sample code to connect. For more information, see SDK overview. |
400 | InvalidApi.ForbiddenInvoke | The call is restricted. Check whether the capability you are calling is restricted. For restricted capabilities, you must find the capability in the console and submit a request. You can call the capability only after the request is approved or you manually activate it. If this is not the case, check whether your account has an overdue payment. |
400 | InvalidApi.NotPurchase | The service is not activated. Activate the service first. |
400 | InvalidApi.OutOfService | The product is not activated. Activate the product. |
400 | InvalidFile.Category | The category of the file content does not meet the requirements. |
400 | InvalidFile.Content | The data is empty or cannot be processed. |
400 | InvalidFile.Decode | The file cannot be decoded. |
400 | InvalidFile.Download | The file cannot be downloaded. Check your on-premises network and whether the link is accessible. For information about file URLs that are not for OSS in the China (Shanghai) region, see Process file URLs. |
400 | InvalidFile.Region | The file URL does not belong to the specified region. |
400 | InvalidFile.Resolution | The file resolution is invalid. |
400 | InvalidFile.Type | The file type is incorrect. Check the file type and use a supported file type as described in the API document for the algorithm. Alibaba Cloud Visual Intelligence API reads the file to get the actual file type instead of judging the type by the file extension. Checking only the file extension is not valid. For more information about how to determine and process file types, see Determine and process file types. |
400 | InvalidFile.Unsafe | The file link is insecure. |
400 | InvalidFile.URL | The file URL is invalid. |
400 | InvalidImage.Content | Check the image content as described in the algorithm document. Replace the image with one that meets the algorithm's requirements. |
400 | InvalidImage.Decode | Check whether the image can be opened. |
400 | InvalidImage.Download | The image cannot be downloaded. Check your on-premises network, whether the link is accessible, and whether the OSS link has expired. For information about image URLs that are not for OSS in the China (Shanghai) region, see Process file URLs. URLs do not support spaces or Chinese characters. If a URL contains these characters, encode them using URL encoding before you pass the URL. |
404 | InvalidImage.NotFoundFace | No face was found in the image. Check whether your image contains a face or if the face is too small. |
400 | InvalidImage.REGION | The region of the image link is incorrect. For information about image URLs that are not for OSS in the China (Shanghai) region, see Process file URLs. |
400 | InvalidImage.Resolution | The file resolution exceeds the limit. Check the file resolution and content, modify the resolution, and then retry. |
400 | InvalidImage.Timeout | The image download timed out. Check whether the link is accessible and check your on-premises network. |
400 | InvalidImage.Type | The image type is incorrect. Check the image type and use a supported image type as described in the API document for the algorithm. |
400 | InvalidImage.URL | The image link is invalid. Check whether the image link is accessible. For information about image URLs that are not for OSS in the China (Shanghai) region, see Process file URLs. For OSS links in the China (Shanghai) region, use standard OSS domain names. Accelerated domain names and custom domain names are not supported. |
400 | InvalidParameter | The input parameter is invalid. |
400 | InvalidParameter.BadRequest | The input parameter is missing or invalid. |
400 | InvalidParameter.Format | The format of the input parameter is incorrect. |
400 | InvalidParameter.NotFound | The parameter is incorrect. Check the parameter value against the API document for the algorithm and the error message. Check for extra spaces or other special characters before or after the parameter value. |
400 | InvalidParameter.TooLarge | The parameter is incorrect. The file size exceeds the limit. Adjust the file size as described in the API document for the algorithm. |
400 | InvalidRamRole | You do not have 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 | The parameter is incorrect. Check the parameter value and the file content. For example, check whether the image content is incomplete or too blurry. |
400 | InvalidSide | The specified parameter `Side` is not valid. Enter the correct `Side` parameter as described in the document. |
400 | InvalidTimeStamp.Expired | The timestamp has expired. Update the timestamp. |
400 | MissingAccessKeyId | The AccessKey ID is not provided. Check whether the AccessKey ID and AccessKey secret are correct. |
400 | MissingParameter | A required input parameter is missing. |
400 | ParameterError | The parameter is incorrect. Check the parameter value. |
503 | ServiceUnavailable | The service is unavailable. If the server has returned a RequestId, contact us through the DingTalk group (23109592). |
400 | SignatureDoesNotMatch | The signature is incorrect. Recalculate the signature. For more information, see Request signature. |
400 | SignatureNonceUsed | The signature nonce has already been used. Recalculate the signature. For more information, see Request signature. |
400 | Throttling | Throttling is triggered. For paid API operations, purchase a higher queries per second (QPS). For free API operations with special requirements, contact us through the DingTalk group (23109592). Note When throttling is triggered, both `Throttling` and `Throttling.User` may occur. Consider both when handling the error. |
400 | Throttling.User | The traffic for this period has exceeded the limit. For paid API operations, purchase a higher QPS. For free API operations with special requirements, contact us through the DingTalk group (23109592). Note When throttling is triggered, both `Throttling` and `Throttling.User` may occur. Consider both when handling the error. |
408 | Timeout | The request timed out. |
400 | Unauthorized | You do not have RAM permissions. Contact your Alibaba Cloud account to grant you the AliyunVIAPIFullAccess permission. For more information, see Control access permissions using RAM policies. |
Common error codes
For common API error codes, see the API Error Center.
Troubleshooting suggestions
If a service request returns an error code, find the cause in the error code description to resolve the issue. The following suggestions can help you troubleshoot common errors.
URL-related error codes
These error codes usually indicate that the file URL does not meet the requirements, such as being insecure or invalid. For more information, see Process file URLs.
Image loading error codes
These errors are typically related to image URLs and can be caused by issues such as download failures or region mismatches. We recommend that you use the China (Shanghai) region. If you generate a URL using OSS, the OSS bucket must also be in the China (Shanghai) region. For more information, see Process file URLs.
Parameter-related error codes
These error codes usually indicate that the input parameters do not meet the requirements, such as missing parameters or incorrect parameter types. You can refer to the request parameters table in the corresponding API document to verify that your input parameters are correct.
System service error codes
If this type of error code occurs, retry the service request. If the problem persists, provide feedback in the DingTalk group (23109592).