Skip to Content
Mux Docs: Home

Stream video files

This guide will show you how to send video files into Mux and get them ready for HLS playback. If you don't know what HLS is, don't worry, we'll talk about that later. Let's start by getting one of your videos into Mux.

1Get an API Access Token

For a guided example of how to make API Requests from your local environment, see the guide and watch this video tutorial: Make API Requests.

The Mux Video API uses a token key pair that consists of a Token ID and Token Secret for authentication. If you haven't already, generate a new Access Token in the Access Token settings of your Mux account dashboard.

Mux access token settings

The access token should have Mux Video Read and Write permissions.

Mux Video access token permissions

Access Tokens also belong to an Environment. Be sure to use the same Environment when using Mux Video and Mux Data together, so the data from Mux Data can be used to optimize your Mux Video streams.

Mux access token environment

2POST a video

Full API ReferenceAPI

To start making API requests to Mux, you might want to install one of our officially supported API SDKs. These are lightweight wrapper libraries that use your API credentials to make authenticated HTTP requests to the Mux API.

# mix.exs
def deps do
    {:mux, "~> 1.8.0"}

Videos stored in Mux are called assetsAPI. To create your first video asset, send a POST request to the /assets endpointAPI and set the "input" property to the URL of a video file that's accessible online.

Note that Mux does not store the original file in its exact form, so if you want to retain your masters, don't delete them after submitting to Mux. Mux will also never need to download your video file again, unless you use it to create more assets.

curl \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{ "input": "{INPUT_URL}", "playback_policy": "public" }' \

The response will include an Asset ID and a Playback ID.

  • Asset IDs are used to manage assets using (e.g. to read or delete an asset).
  • Playback IDsAPI are used to stream an asset to a video player through You can add multiple playback IDs to an asset to create playback URLs with different viewing permissions, and you can delete playback IDs to remove access without deleting the asset.
  "data": {
    "status": "preparing",
    "playback_ids": [
        "policy": "public",
        "id": "TXjw00EgPBPS6acv7gBUEJ14PEr5XNWOe"
    "mp4_support": "none",
    "master_access": "none",
    "id": "01itgOBvgjAbES7Inwvu4kEBtsQ44HFL6",
    "created_at": "1607876845"

3Wait for "ready"

Full API ReferenceAPI

As soon as you POST a video, Mux begins downloading and processing the video. For shorter files, this often takes just a few seconds. Very large files over poor connections may take a few minutes (or longer).

When the video is ready for playback, the asset "status" changes to "ready".

The best way to do this is via webhooks. Mux can send a webhook notification as soon as the asset is ready. See the webhooks guide for details.

If you can't use webhooks for some reason, you can manually poll the asset APIAPI to see asset status. Note that this only works at low volume. Try this example:

Auto-populate an example request:

curl{ASSET_ID} \
  -H "Content-Type: application/json" \

Please don't poll this API more than once per second.

4Watch your Video

To play back an asset, create a playback URL using the PLAYBACK_ID you received when you created the asset.{PLAYBACK_ID}.m3u8
implementation ''

// Create a player instance.
SimpleExoPlayer player = new SimpleExoPlayer.Builder(context).build();
// Set the media item to be played.
// Prepare the player.

See the playback guide for more information about how to integrate with a video player.

After you have everything working integrate Mux Data with your player for monitoring playback performance.

Preview your video at{PLAYBACK_ID} is an open source project by Mux that allows you to add a video and get a shareable link to stream it.

Go to{PLAYBACK_ID} to preview your video streaming. This URL is shareable and automatically generated using the video playback ID. Copy the link below and open it in a browser to view your video.{PLAYBACK_ID}

5Manage your Mux assets

After you have assets created in your Mux environment, you may find some of these other endpoints handy:

More Video methods and descriptions are available at the API DocsAPI.

6Video FAQs

On-demand video assets support multiple alternative audio tracks. Live streams only support a single audio track.

You may want your users to be able to select a language on the player and view a live stream showing the same video content but play different audio. One workaround would be first, ingest multiple streams with one in each language. Then add logic to the player to switch between different playback URLs and the complete stream when the user changes the language.

Next Steps

Set up your iOS application, Android application or web application to start playing your Mux assets
Now that you have Mux assets, build rich experiences into your application by previewing your videos with Thumbnails and Storyboards
Add the Mux Data SDK to your player and start collecting playback performance metrics.

Was this page helpful?