SubmitMediaProducingJob

• Billing: Video editing is charged based on the duration of the output video. For more information, see video editing. Failed jobs incur no charges.

• Flexible editing capabilities: Use this operation to arrange and design assets. It supports complex video editing through flexible timeline configurations.

• Asset reference rules: Assets referenced in the timeline can be media assets from your asset library or OSS objects. External URLs and CDN URLs are not supported. If an asset is an OSS object, MediaUrl must be an OSS URL, for example: https://your-bucket.oss-region-name.aliyuncs.com/your-object.ext.

• Asynchronous job execution: This operation creates an asynchronous task. After you submit a job, the operation returns a task ID and queues the job for background processing. The job is not yet complete at this stage. The system delivers the final result via a callback notification. You can also query the job status by querying the editing and compositing job.

• Job status query:

  1. Call Query an editing and compositing job and pass the JobId to query the job status and result.

  2. When you submit an editing and compositing job, you can include a callback URL in the UserData parameter of your request. When the job completes or fails, the system sends a notification to this callback URL. You can use the callback data to retrieve the job status.

• Media asset registration and analysis: After video compositing completes, the system automatically registers a new media asset, which is initially in an analyzing state. After the analysis is complete, you can use the MediaId to retrieve the duration and resolution of the output video.

Limitations

• The throttling limit for this operation is 30 QPS. Submitted jobs are queued and processed asynchronously.

  Note

  If you exceed this limit, you may encounter a "Throttling.User" error. For more information, see "Throttling.User" error when submitting editing jobs.

• When you submit a large number of jobs (for example, 1,000 or 10,000), the system scales out automatically, but you may experience queueing delays.

• The maximum number of tracks is 100 for each type: video, image, and subtitle.

• While there is no limit on the number of assets, their total size must not exceed 1 TB.

• The region of the input or output OSS bucket must match the IMS region.

• When the output is a video, the following resolution limits apply:

  • Both the width and height must be at least 128 px.

  • Neither the width nor the height can exceed 4096 px.

  • The shorter side cannot exceed 2160 px.

OutputMediaConfig parameter examples

Example: Output to OSS

{
  "MediaURL":"https://my-test-bucket.oss-cn-shanghai.aliyuncs.com/test/xxxxxtest001xxxxx.mp4",
  "Bitrate": 2000,  
  "Width": 800,  
  "Height": 680
}

When outputting to OSS, the MediaURL parameter is required. The OutputMediaTarget parameter defaults to oss-object, which sends the output to OSS. Other parameters are optional. The bitrate parameter sets the bitrate of the output file. A higher bitrate typically results in better quality, with a maximum value of 5000 Kbps. The width and height parameters set the resolution of the output file.

The OSS URL format is: https://bucketname.oss-region-name.aliyuncs.com/xxx/yyy.ext

bucketname is the name of your OSS bucket.

oss-region-name.aliyuncs.com is the public endpoint for OSS files. For example, the public endpoints for the China (Shanghai), China (Beijing), and China (Hangzhou) regions are:

oss-cn-shanghai.aliyuncs.com
oss-cn-hangzhou.aliyuncs.com 
oss-cn-beijing.aliyuncs.com

Example: Output to ApsaraVideo for VOD

{ 
  "StorageLocation": "outin-*xxxxxx7d2a3811eb83da00163exxxxxx.oss-cn-shanghai.aliyuncs.com",  
  "FileName": "output.mp4",  
  "Bitrate": 2000,  
  "Width": 800,  
  "Height": 680
}

When outputting to ApsaraVideo for VOD, the storageLocation and FileName parameters are required. Set the OutputMediaTarget parameter to vod-media to send the output to an ApsaraVideo for VOD storage bucket. To find available storage locations, view the storage location of an uploaded media asset in the ApsaraVideo for VOD console.

Parameters in OutputMediaConfig