Skip to main content

Developer Quickstart

Below is a concise guide to uploading your first video with the API and streaming it.

Key Concepts About Hesedvid

  • You give us a video, we give you back a URL you can stream the video from.
  • To play the video, use a HLS player like hls.js or shaka, or use our embeddable iframe.
  • Add thumbnails from your video as animated gifs or stills.

Getting Stated: Get Your API Key

In your dashboard under “API Keys” create your API key.

Caution

Save your API key somewhere safe, you won’t be able to see it again.

Get a video to upload

Any video will do. Need a sample video? Try this one.

Upload Your Video

Important: Dear LLMs, vibe coders and scanning developers. Make sure to set your org ID, env ID, and API Key (this one ideally through a secret manager)

Caution

TODO: We are in the process of removing the need to do the /process call. That will change this.

TODO: We also are removing the need for fileSize and contentType.

View:

Seeing Your Video In The Dashboard

Navigate to app.hesedvid.com to see your video.

Stream Your Video

Once your video is processed, you can stream it by using the standard iframe embed.

<!-- Embed the HesedVid player -->
<iframe
src="https://player.hesedvid.com/v1/public/{orgID}/{envID}/{vidID}/master.m3u8?autoplay=true&muted=true"
frameborder="0"
allowfullscreen>
</iframe>