Skip to main content

Uploading With Accessible URL

When This Option Is Ideal

You’ve got a video accessible on the internet. Maybe it’s in a public S3 bucket, or maybe you can make a pre-signed URL for us to access the video.

You want to make this video playable for everyone else on Hesedvid.

Give us the URL and some config for how to process it. We’ll give you back a video URL for playback by anyone.

The Single-Step Process

This workflow has one step:

  1. Video Config. Tell Hesedvid things like the video quality and resolutions you want available. Include your video URL.

Upload Your Video

POST https://api.hesedvid.com/v1/{orgID}/environments/{envID}/videos/upload // TODO: We need to figure this out

Required Parameters

FieldTypeDescription
fileNamestringThe name of the file including the file extension
videoQualitystringQuality preset: standard, high, ultra
allowPublicAccessbooleanWhether video can be accessed without authentication
videoURLbooleanThe URL Hesedvid can use to request your video

To decide on which video quality you might want to use, click here.

Caution

TODO: We need a comparison page

Optional Parameters

FieldTypeDefaultDescription
videoNamestring-Display name for the video. Useful for finding the video in the dashboard or via API.
maxEdgeLengthinteger(auto-detected)Maximum resolution: 480, 720, 1080, 1440, 2160
maxFrameRateinteger(auto-detected)Maximum frame rate (fps)
EncodingModestringfastEither fast or slow. Use slow for better quality and slightly faster loading speed.
audioCodecstringaacAudio codec: aac, mp3, ac3, eac3

Response body

A successful response will include this:

{
"body": {
"videoID": "pubvid_XXX"
}
}

Code Examples


How To Play The Video You Just Uploaded

After you upload your video, it will begin processing. When it’s done processing, you can take the public Video ID you got from step 1 and start to play the video:

<!-- Replace the {vidID} with the public video ID from step 1 -->
<iframe
src="https://player.hesedvid.com/v1/public/{orgID}/{envID}/{vidID}/master.m3u8?autoplay=true&muted=true"
frameborder="0"
allowfullscreen>
</iframe>

Check out our “Video Player” docs for more information.