Preprocesses a video by using the production studio.

  • During video preprocessing, videos are transcoded to meet the playback requirements of the production studio. Therefore, you are charged for video preprocessing. You can submit a ticket for information about the production studio service.
  • You can obtain the preprocessing result in the TranscodeComplete event notification. If the value of the Preprocess parameter is true in the event notification, the video is preprocessed.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes SubmitPreprocessJobs

The operation that you want to perform. Set the value to SubmitPreprocessJobs.

PreprocessType String Yes LivePreprocess

The preprocessing type. Set the value to LivePreprocess, which indicates that the video is preprocessed in the production studio.

VideoId String Yes 7d2fbc3e27*****0bdb0e08e55f

The ID of the video.

Response parameters

Parameter Type Example Description
PreprocessJobs Array of PreprocessJob

The job information.

JobId String bb396607fd*****11fee9effbb99c

The ID of the job.

RequestId String D08EF493-1A69-42*****6D-EC66BE3339B3

The ID of the request.


Sample requests

&<Common request parameters>

Sample success responses

XML format


JSON format

    "SubmitPreprocessJobsRespon": {
        "RequestId": "D08EF493-1A69-42*****6D-EC66BE3339B3",
        "PreprocessJobs": {
            "PreprocessJob": {
                "JobId": "bb396607fd*****11fee9effbb99c"

Error codes

For a list of error codes, visit the API Error Center.

Common errors

The following table describes the common errors that this operation can return.

Error code

Error message

HTTP status code



The video does not exist.


The error message returned because the video does not exist.


The specified resource %s does not exist.


The error message returned because the specified resource does not exist.


Status of the video is illegal.


The error message returned because the video status is invalid. You can preprocess a video only in the UploadSucces, Normal, Checking, or Transcoding state.

SDK examples

We recommend that you use server SDKs to call this operation. You can view the sample code of different languages to call this operation by clicking the following links: