Skip to content
Welcome to the new, unified Livepeer documentation! 👋
Transcode Video w/ Storj


This guide will describe how to use the Livepeer transcode API to transcode and store video files in Storj using Storj’s S3 API.

There are code examples provided for reference.

Storj S3 Credentials

This step assumes that you have already created an account at (opens in a new tab).

Follow the Storj guide for generating S3 credentials (opens in a new tab) using either the web interface or uplink. Make sure that the credentials have the proper read/write permissions for the bucket that your video files will be read from and that transcoded videos will be written to. The access key and secret key of the credentials will be used in the next step.

Upload Video to Storj

Make sure you have a video file uploaded to your Storj bucket. You must upload the video file using one of the following methods:

Transcode with Livepeer

This step assumes that you have already created a Livepeer Studio account (opens in a new tab) and an API key (opens in a new tab).

Submit the following request:

curl --location --request POST '' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  • $API_KEY should be your Livepeer Studio API key
  • $ACCESS_KEY_ID should be the access key and $SECRET_ACCESS_KEY should be the secret key of the S3 credentials you generated in the previous step
  • input.bucket should be the name of your Storj bucket
  • input.path should be the path that your video file can be found in the Storj bucket
  • outputs.hls.path will be the path that the HLS playlist and mpegts segments will be found in when transcoding is complete
  • outputs.mp4.path will be the path that the MP4 video files will be found in when transcoding is complete
  • profiles is an optional parameter to specify the desired properties of transcoded video

Use the task ID in the response to query for the transcoding task status. Once the task is complete, the HLS playlist and mpegts segments will be available at outputs.hls.path and MP4 output videos will be available at outputs.mp4.path.

For more information about transcode API usage refer to the docs.

Playback From Storj

You can create a public playback URL for the transcoded video by first creating a shared Storj URL:

  • If you are using uplink, follow the Storj Link Sharing guide (opens in a new tab) to create a URL for your bucket
  • Ex. uplink share sj://demo-bucket/ --url --not-after=none --base-url=
  • If you are using the web interface, navigate to your bucket under “Buckets” and click the “Share Bucket” button to create a URL for your bucket

The URL should look like this:

Suppose outputs.hls.path for the request in the previous step was /samplevideo/hls. The master HLS playlist used for playback will be available at:

You can playback the transcoded video from Storj using this URL with any HLS player. For example,…/demo-bucket/samplevideo/hls/index.m3u8 will playback the video using the hosted Livepeer player.

Code Examples