Create Profile

​

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.

Body
application/json
  • format
    Type: string enum
    required

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

    values
    • ABR
    • MP4
  • name
    Type: string
    required

    Profile name or identifier.

  • animated_gif
    Type: object

    Create an animated GIF from a video.

  • audio_only
    Type: 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

  • crop
    Type: object

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

  • enable_drm
    Type: boolean

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

  • generate_subtitles
    Type: 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.

  • height
    Type: 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.

  • image_overlay
    Type: object

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

  • mp4_access
    Type: boolean

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

  • pad
    Type: object

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

  • per_title_encoding
    Type: 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

Responses
  • application/json
  • application/json
  • application/json
Request Example for post/video/profiles
import Gumlet from '@gumlet/nodejs-sdk';

const client = new Gumlet({
  apiKey: process.env['API_KEY'], // defaults to the API_KEY env var
});

const videoProfile = await client.videoProfiles.create({
  name: 'Gumlet-Profile-1',
  format: 'ABR',
});

console.log(videoProfile);

{
  "profile_id": "61921fb10822a81d955d1730",
  "name": "Gumlet-Profile-1",
  "transformations": {
    "format": "hls",
    "audio_codec": [
      "aac"
    ],
    "video_codec": [
      "libx264"
    ],
    "thumbnail": [
      "auto"
    ],
    "thumbnail_format": "png",
    "mp4_access": false,
    "per_title_encoding": true
  },
  "created_at": 1636966321742
}

200