This document explains the response formats for API requests and the HTTP response codes that may be returned.

Response Formats

Successful Response

When a request is successful, the service returns a JSON response containing a persistentId:

{
    "persistentId": "<persistentId>"
}

The persistentId is a unique identifier for tracking your task. You can use this ID when contacting support for troubleshooting assistance.

Important: The persistentId only confirms that your request was successfully submitted. It does not indicate that the media processing task completed successfully. To monitor task status, we recommend configuring a callback to receive status notifications.

Error Response

When a request fails, the service returns a JSON response containing error details:

{
    "code": "<HTTP_RESPONSE_CODE>",
    "message": "<ERROR_MESSAGE>"
}

Field	Description
code	The HTTP response code. See HTTP Response Codes below.
message	A description of why the media processing request failed.

HTTP Response Codes

General Response Codes

Code	Response Message	Description
200	OK	The operation was successful.
304	Not Modified	The file is up to date, and no changes were made.
401	Authorization Required	An Authorization header is required for this request.
401	AK/SK Not Found	The AccessKey (AK) or AccessKey Secret (SK) was not found.
401	Token Invalid	The provided request token is invalid.
401	ExpireTime Is Null	The ExpireTime field is empty.
401	Token Format Invalid	The format of the request token is invalid.
401	Bucket Access Denied	Access to the requested bucket is denied.
401	The Persistent File Already Exists	The persistent file already exists.
404	Bucket Not Found	The bucket specified in the request does not exist.
404	File Not Found	The requested file was not found.
404	bucketErrorPage	The requested resource was not found.
404	Bucket Not Binding Mirror	The requested bucket is not bound to a mirror source.
405	Token Required	A token is required for this request.
406	File Already Exist	The file already exists.
406	File Is Busy, Please Retry Later	The file is being processed. Please try again later.
500	Internal Server Error	An internal server error occurred.

Media Processing Response Codes

Code	Response Message	Description
400	Transfer Parameters Error	There is an error in the transcoding parameters.
401	Ops Invalid	The fops value in the request is invalid.
404	Video Persistent Progress Info Not Found	Information about the file’s processing task was not found.
579	Json Response	An exception occurred while handling the callback response from the business server.