SubmitMediaProducingJob

• Billing: Video clip editing is billed based on the duration of the produced video. For details, see Video clip. No fees are charged for failed jobs.

• Diverse editing capabilities: When you need to arrange and design materials based on your creative ideas, invoke this operation. This operation supports flexible Timeline configurations to meet complex video clip editing requirements.

• Material reference rules: Materials referenced in the cloud editing timeline can be media assets in the media library or OSS files. External URLs or CDN URLs are not supported. When the material is an OSS file, MediaUrl supports only OSS URL format, such as https://your-bucket.oss-region-name.aliyuncs.com/your-object.ext.

• Asynchronous task execution: This operation is an asynchronous task. After you commit a task, a task ID is returned (the task is not yet completed and enters a background queue for asynchronous execution). The final result is sent through a callback notification. You can also proactively query the task status by calling GetMediaProducingJob.

• Task status query:

  1. Invoke GetMediaProducingJob and pass in the JobId to query the task status and result.

  2. When committing a media producing job, you can set UserData in the request parameters to include a callback URL. When the editing task is completed or fails, the system sends a notification to the callback URL. You can process the callback data to obtain the task status.

• Media asset registration and analysis: After video compositing is completed, the media asset is automatically registered. At this point, the media asset is still in the analyzing state. After the analysis is completed, you can obtain the duration and resolution of the produced video based on the MediaId.

Limits

• The throttling limit of this operation is 30 QPS (requests per second for submitting tasks). Submitted tasks enter a background queue and are processed asynchronously.

  Note

  If this limit is exceeded, you may encounter a "Throttling.User" error. For more information, see Throttling.User error when submitting an editing task.

• When you submit a large number of tasks (such as 1,000 or 10,000), the system dynamically scales up, but there may be some queuing time.

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

• There is no limit on the number of materials, but the total file size of all materials cannot exceed 1 TB.

• The region of the input or output OSS bucket must be the same as the region where IMS is used.

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

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

  • Both width and height cannot exceed 4096 px.

  • The short side cannot exceed 2160 px.

OutputMediaConfig parameter examples

Example: Output to OSS

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

When outputting to OSS, MediaURL is required. The default value of the OutputMediaTarget parameter is "oss-object", which indicates output to OSS. Other parameters are optional. Bitrate is used to set the bitrate of the output media. Generally, a higher bitrate produces clearer video. The maximum value is 5000. Width and Height are used to set the resolution of the output media.

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

bucketname is the name of the OSS bucket.

oss-region-name.aliyuncs.com is the public endpoint of the OSS file. For example, the endpoints for Singapore, Japan (Tokyo), and US (Virginia) are:

oss-ap-southeast-1.aliyuncs.com
oss-ap-northeast-1.aliyuncs.com 
oss-us-east-1.aliyuncs.com

Example: Output to VOD

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

When outputting to VOD, the StorageLocation and FileName parameters are required. Set the OutputMediaTarget parameter to "vod-media" to output to the VOD storage bucket. You can view the available storage locations in VOD after uploading media assets and checking the storage address of the media asset.

Settings of the OutputMediaConfig structure