Direct Upload

Upload files directly to Gumlet

Create Video Collection

To use direct-upload facility first step is to create a new video collection with Direct Upload as Collection Origin Type.

Once a collection is created you can use the direct-upload facility with either Gumlet Dashboard or REST APIs.

Using Dashboard

1. Go to the video manager of the above-created collection

2. Process new video and set necessary parameters

3. Upload Video File

Start uploading a video file by selecting it from the file browser.

After successful completion of the upload, you will be redirected back to the video manager.

4. Check Asset status in the video manager

Using REST APIs

1. Create an authenticated Gumlet URL

The first step is creating a new Direct Upload Asset with Asset Parameters as you want.The Gumlet API will return an authenticated URL that you can use directly, as well as an asset ID specific to that Direct Upload Asset so you can check the status later via the API or in Gumlet Video Manager.

curl -L -X POST 'https://api.gumlet.com/v1/video/assets/upload' \
-H 'Authorization: Bearer <YOUR_API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
    "source_id": <DIRECT UPLOAD COLLECTION ID>,
    "format": "hls",
    "resolution": ["240p", "360p", "720p", "1080p"],
    "image_overlay": {
        "url": "https://assets.gumlet.io/assets/logo.svg?format=png",
        "height": "10%",
        "width": "10%",
        "horizontal_align": "left",
        "horizontal_margin": "5%",
        "vertical_align": "top",
        "vertical_margin": "5%"
    }
}'
{
    "asset_id": "60c1b50a6676496c4bd9bec7",
    "progress": 0,
    "created_at": 1623307530439,
    "status": "upload-pending",
    "input": {
        "transformations": {
            "format": "hls",
            "resolution": [
                "240p",
                "360p",
                "720p",
                "1080p"
            ],
            "video_codec": [
                "libx264"
            ],
            "audio_codec": [
                "aac"
            ],
            "image_overlay": {
                "url": "https://assets.gumlet.io/assets/logo.svg?format=png",
                "vertical_align": "top",
                "horizontal_align": "left",
                "vertical_margin": "5%",
                "horizontal_margin": "5%",
                "width": "10%",
                "height": "10%"
            },
            "thumbnail": [
                "auto"
            ],
            "thumbnail_format": "png",
            "mp4_access": false,
            "per_title_encoding": true,
            "process_low_resolution_input": false,
            "keep_original": true
        },
        "source_url": "60c1af0c667649f5a0d9ada2/60c1b50a6676496c4bd9bec7/origin-60c1b50a6676496c4bd9bec7"
    },
    "output": {
        "format": "hls",
        "status_url": "https://api.gumlet.com/v1/video/assets/60c1b50a6676496c4bd9bec7",
        "playback_url": "https://video.gumlet.io/60c1af0c667649f5a0d9ada2/60c1b50a6676496c4bd9bec7/1.m3u8",
        "thumbnail_url": [
            "https://video.gumlet.io/60c1af0c667649f5a0d9ada2/60c1b50a6676496c4bd9bec7/thumbnail-1-0.png"
        ]
    },
    "upload_url": "https://gumlet-video-user-uploads.s3.us-west-2.amazonaws.com/gumlet-user-uploads-prod/60c1af0c667649f5a0d9ada2/60c1b50a6676496c4bd9bec7/origin-60c1b50a6676496c4bd9bec7?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA4WNLTXWDOHE3WKEQ%2F20210610%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20210610T064530Z&X-Amz-Expires=3600&X-Amz-Signature=677006b4486468416c1af44dbb1a4482aaf50a714d1525745a2ff68f567d3164&X-Amz-SignedHeaders=host"
}

2. Use URL to upload a file

Once you have got upload_url like in the above response example, you'll use the secured URL to make a PUT request that includes the file in the body as following.

curl -v -X PUT -T video.mp4 <upload_url>

On successful completion of the cURL command, you should find new Assets in the Gumlet Video Manager with the settings you specified in the first step to create Direct Upload Asset.

3. Access uploaded video

You can access your uploaded video by using Video Asset Status API. You will receive original_download_url field in response of the API which will contain a URL for accessing the uploaded video.


Did this page help you?