Create Profile

post

https://api.gumlet.com/v1/video/profiles

Gumlet provides the functionality of creating multiple video assets using the same set of parameters. A Video profile is a set of parameters that can be referenced/used while creating a video as a single parameter.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

name

string

required

Defaults to Gumlet-Profile-1

Profile name or identifier.

format

string

enum

required

Defaults to ABR

Transcode and deliver the asset in the requested format. The options can be one of ABR (HLS + DASH) and MP4.

Allowed:

width

string

Resize video with the given width. Can be an absolute value in pixels or a percentage value with the % suffix. Specified values greater than the original asset width will be ignored. Only applicable when specified format is MP4.

height

string

Resize video with the given height. Can be an absolute value in pixels or a percentage value with the % suffix. Specified values greater than the original asset height will be ignored. Only applicable when specified format is MP4.

resolution

string

Required resolutions of the transformed asset in case of HLS or MPEG-DASH delivery format. Can be a comma separated string out of the following values: 240p, 360p, 480p, 540p, 720p, and 1080p . Re-sized rendition will retain the input aspect ratio.

crop

object

This transformation can be used to crop the video by defining a rectangular area within the dimensions of the output video.

pad

object

This transformation can be used to add padding to the video.

trim

object

Trim transformation can be used to trim videos based on time duration.

image_overlay

object

Image overlay can be used to brand a video or add a visual label in the form of an image.

text_overlay

object

Text overlay can be used to brand a video or add a label in the form of text.

animated_gif

object

Create an animated GIF from a video.

generate_subtitles

object

Gumlet allows to generate subtitles from the audio stream (use ISO 639-1 Language Codes). Remove this object if you do not want to generate AI subtitles.

mp4_access

boolean

Creates mp4 version for download purpose in case of MPEG-DASH or HLS delivery format. Default: false

per_title_encoding

boolean

Gumlet analyzes each input video on a wide range of visual aspects. Based on the analysis, it chooses a unique set of transcoding options for processing the video. This ensures that the output video is of optimal size and best quality. Default: true

process_low_resolution_input

boolean

Currently, the minimum supported frame size is 57600 (240x240) pixels for HLS/DASH and 21025 (145x145) pixels for MP4 format. However, enabling this flag will allow Gumlet to simply put your video asset into the specified delivery format without transcoding and optimization. Enabling this flag will cause any kind of specified video transformation to be ignored if you input video asset frame size is lower than the minimum supported frame size for the specified format. Default: false

audio_only

boolean

This flag allows Gumlet to transcode and deliver audio-only in the specified format. In this case,This flag allows Gumlet to transcode and deliver audio-only in the specified format. In this case, video transformation and thumbnails/animated GIFs would not be created. Default: false

enable_drm

boolean

Enable DRM encryption for transcoded videos. Gumlet supports Widevine and Fairplay DRMs.

Responses

200200

400400

401401