Output JPG of video with source Aspect Ratio

Shotstack API
1

Hi there. I am hoping to create a JPG of a video with the following request. The problem is that i want to output the JPG aspect ratio with whatever the aspect ratio of the video was, and the output requires that I set a resolution or size. But if I set the resolution, in order to make it output the correct aspect ratio i have to set it, but i don’t know what that is.

Is there a way to have the output of the JPG automatically use the aspect ratio of the source video?

{
            "timeline": {
                "tracks": [
                    {
                        "clips": [
                            {
                                "asset": {
                                    "type": "video",
                                    "src": "",
                                    "trim": 0
                                },

                                "start": 0,
                                "length": 1
                            }
                        ]
                    }
                ]
            },
            "output": {
                "format": "jpg"
            }
        }
2

Interesting request, and I can see its usefulness. Currently, this isn’t automated—you’d need to set width and height manually or via a calculation.

The issue with an auto setting is handling multiple videos or images with different aspect ratios—which one should define the output’s aspect ratio?

3

This could be a useful way to extend the alias property, similar to how the caption asset aliases a text-to-speech or audio asset as its source.

Example:

{
    "timeline": {
        "tracks": [
            {
                "clips": [
                    {
                        "asset": {
                            "type": "video",
                            "src": "",
                            "trim": 0
                        },
                        "start": 0,
                        "length": 1,
                        "alias": "reference"
                    }
                ]
            }
        ]
    },
    "output": {
        "format": "jpg",
        "size": "alias://reference"
    }
}