Video Processing API: Resize a Video (Preserving Original Aspect Ratio) with Java

2 min readApr 27, 2022

Setting up some custom video processing operations? Our suite of Video APIs can help do the trick. The aspect-ratio-preserving iteration of this API stays true to its namesake and supports a wide variety of file input formats. Below, you can follow instructions to implement this API with ready-to-run code provided snippets provided in java.

To start, install the Java SDK with Maven (instructions for Gradle provided on the Cloudmersive API Console). First add a reference to the repository in pom.xml:


After that, add one to the dependency:


Then add the import classes, and below that include the video processing function. After that, all that’s left is to supply your Cloudmersive API key, and you’re all done.

// Import classes:
//import com.cloudmersive.client.invoker.ApiClient;
//import com.cloudmersive.client.invoker.ApiException;
//import com.cloudmersive.client.invoker.Configuration;
//import com.cloudmersive.client.invoker.auth.*;
//import com.cloudmersive.client.VideoApi;
ApiClient defaultClient = Configuration.getDefaultApiClient();// Configure API key authorization: Apikey
ApiKeyAuth Apikey = (ApiKeyAuth) defaultClient.getAuthentication("Apikey");
Apikey.setApiKey("YOUR API KEY");
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
VideoApi apiInstance = new VideoApi();
File inputFile = new File("/path/to/inputfile"); // File | Input file to perform the operation on.
String fileUrl = "fileUrl_example"; // String | Optional; URL of a video file being used for conversion. Use this option for files larger than 2GB.
Integer maxWidth = 56; // Integer | Optional; Maximum width of the output video, up to the original video width. Defaults to original video width.
Integer maxHeight = 56; // Integer | Optional; Maximum height of the output video, up to the original video width. Defaults to original video height.
Integer frameRate = 56; // Integer | Optional; Specify the frame rate of the output video. Defaults to original video frame rate.
Integer quality = 56; // Integer | Optional; Specify the quality of the output video, where 100 is lossless and 1 is the lowest possible quality with highest compression. Default is 50.
String extension = "extension_example"; // String | Optional; Specify the file extension of the input video. This is recommended when inputting a file directly, without a file name. If no file name is available and no extension is provided, the extension will be inferred from the file data, which may cause a different extension to be used in the output.
try {
byte[] result = apiInstance.videoResizeVideo(inputFile, fileUrl, maxWidth, maxHeight, frameRate, quality, extension);
} catch (ApiException e) {
System.err.println("Exception when calling VideoApi#videoResizeVideo");




There’s an API for that. Cloudmersive is a leader in Highly Scalable Cloud APIs.