v1

latestOpenAPI 3.1.02026-07-24650272.2 KB

API Endpoints

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.

post/video/live/assets

Request body

live_source_idstring required

Gumlet live video source/collection id.

resolutionstring 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.

titlestring

Your live stream asset title

mp4_accessboolean

Creates <code>MP4</code> version for download purpose.

orientation'landscape' | 'potrait'

start_atstring date-time

Response

200

statusstring

stream_keystring

live_asset_idstring

live_video_source_idstring

stream_urlstring

created_atinteger

updated_atinteger

vod_asset_idstring

Example response

{
  "status": "created",
  "stream_key": "619231610822a81d955d22f4",
  "live_asset_id": "619231610822a81d955d22f3",
  "live_video_source_id": "6165247368d80232d28d4379",
  "input": {
    "resolution": [
      "720p"
    ]
  },
  "stream_url": "rtmp://livestream-ingest.gumlet.io:1935/app/619231610822a81d955d22f4",
  "output": {
    "playback_url": "https://video.gumlet.io/6165247368d80232d28d4379/619231610822a81d955d22f3/master.m3u8"
  },
  "thumbnail": {
    "preparing": "https://stream.gumlet.io/67e4ecea403562dbea654269/68c3da5947f9ad0c0d513fe2/thumbnail-preparing.png",
    "disconnected": "https://stream.gumlet.io/67e4ecea403562dbea654269/68c3da5947f9ad0c0d513fe2/thumbnail-disconnected.png",
    "end": "https://stream.gumlet.io/67e4ecea403562dbea654269/68c3da5947f9ad0c0d513fe2/thumbnail-end.png"
  },
  "created_at": 1636970849188,
  "updated_at": 1636970849188
}