Create Live Asset

​

A live asset refers to a media content/video that is live-streamed through Gumlet. This endpoint creates a live streaming asset allowing users to live stream a video that will be pushed to Gumlet.

Body
application/json
  • live_source_id
    Type: string
    required

    Gumlet live video source/collection id.

  • resolution
    Type: string
    required

    Required resolutions in HLS delivery format for live stream. Can be an array of string out of the following values: 240p, 360p, 480p, 540p, 720p, and 1080p. Re-sized rendition will retain the input aspect ratio.

  • mp4_access
    Type: boolean

    Creates MP4 version for download purpose.

  • orientation
    Type: string enum
    values
    • landscape
    • potrait
  • start_at
    Type: string Format: date-time

    the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

  • title
    Type: string

    Your live stream asset title

Responses
  • application/json
  • application/json
  • application/json
Request Example for post/video/live/assets
curl https://api.gumlet.com/v1/video/live/assets \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "live_source_id": "",
  "resolution": "",
  "title": "",
  "mp4_access": true,
  "orientation": "landscape",
  "start_at": ""
}'

{
  "status": "created",
  "stream_key": "68c3da5947f9ad0c0d513fe3",
  "live_asset_id": "68c3da5947f9ad0c0d513fe2",
  "live_video_source_id": "67e4ecea403562dbea654269",
  "input": {
    "resolution": [
      "360p",
      "480p",
      "720p",
      "240p",
      "1080p"
    ],
    "title": "gumlet-stream"
  },
  "stream_url": "rtmp://44.245.28.195:1935/app/68c3da5947f9ad0c0d513fe3",
  "output": {
    "playback_url": "https://stream.gumlet.io/67e4ecea403562dbea654269/68c3da5947f9ad0c0d513fe2/main.m3u8",
    "recording_playback_url": "https://video.gumlet.io/6867815b6410daa283f85532/68c3da5947f9ad0c0d513fe4/main.m3u8",
    "recording_dash_playback_url": "https://video.gumlet.io/6867815b6410daa283f85532/68c3da5947f9ad0c0d513fe4/main.mpd"
  },
  "vod_asset_id": "68c3da5947f9ad0c0d513fe4",
  "created_at": 1757665882451,
  "updated_at": 1757665882451
}

200