Get Started : Upload, Watch & Manage Videos in Minutes

The FastPix Video API lets you build and stream videos that fit your workflow and design. You can customize videos for specific users and use cases. With streamlined setup and integration, developers can build modern video interactions and experiences for any stack, any app, at any scale, anywhere - with a faster time to market.

Step 1

Activate Account

Step 2

Upload your first video using dashboard

Step 3

Upload a video using API

Step 4

Check for status

Step 5

Watch your video

Step 6

Manage your media

Start using FastPix

Quickly get started with streaming videos; upload and playback videos in your application with FastPix video APIs.

Activate your account

To get started with FastPix, activate your account and follow the dashboard setup steps in the Activate Account page. Learn more about creating your account, setting up a workspace, and generating your API credentials (Access Token ID and Secret Key).

📘
NOTE
The Activate account guide includes screenshots and step-by-step instructions for creating a workspace, generating Access Token ID and Secret Key, selecting permissions, and securely downloading credentials as a .env file.

Upload your first video using dashboard

Now that your FastPix account is set up, you can upload videos in two ways:

Watch this Video Tutorial for a better understanding.

Upload a video using API

To upload a video to FastPix, you need to follow these steps:

a. Identify the video : Every video that you store in FastPix is called a Media.

b. Create a Media: To create your first media, send a POST request to the /on-demand API endpoint, where the input value must be the URL of a video file that is accessible online.

c. Use a demo video link: For your convenience, we’ve provided a demo video link that you can use to send the request. FastPix retrieves the video from the provided URL and store it as a media asset.

https://static.fastpix.io/fp-sample-video.mp4

By using this link, you can easily familiarize yourself with the process of creating a media in FastPix. After you’re comfortable with the process, you can start uploading your own videos and expanding your media library.

In the following curl command, replace ACCESS_TOKEN_ID and SECRET_KEY with the Access Token ID and Secret Key values from the .env file you downloaded.

curl -X POST "https://api.fastpix.io/v1/on-demand" \
  -u {ACCESS_TOKEN_ID}:{SECRET_KEY} \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": [
      {
        "type": "video",
        "url": "https://static.fastpix.io/fp-sample-video.mp4"
      }
    ],
    "accessPolicy": "public"
  }'

The response contains unique identifiers like a Media ID and a Playback ID.

Media IDs are essential for media management on api.fastpix.io/v1. For instance, you can use them to read or delete specific media files.
Playback IDs are used to deliver media content to a video player through stream.fastpix.io. You can link multiple playback IDs to a single media file to create streaming or playback URLs with different access permissions. Additionally, you can also delete playback IDs to revoke viewing rights without the need to erase the actual media file.

{
  "success": true,
  "data": {
    "id": "4ee2ec6a-7426-4501-8051-277ea1eb4014",
    "trial": true,
    "status": "Created",
    "createdAt": "2025-10-30T09:46:32.098964Z",
    "updatedAt": "2025-10-30T09:46:32.098967Z",
    "playbackIds": [
      {
        "id": "fe142e1f-c9c6-4098-b350-1bdf97b9b332",
        "accessPolicy": "public",
        "accessRestrictions": {
          "domains": {
            "defaultPolicy": "allow",
            "allow": [],
            "deny": []
          },
          "userAgents": {
            "defaultPolicy": "allow",
            "allow": [],
            "deny": []
          }
        }
      }
    ],
    "sourceAccess": false,
    "maxResolution": "1080p",
    "inputs": [
      {
        "type": "video",
        "url": "https://static.fastpix.io/fp-sample-video.mp4"
      }
    ],
    "subtitles": {},
    "optimizeAudio": false
  }
}

NOTE

FastPix does not store the original video file in it's exact form. Therefore, if preserving your original high-quality files is crucial, refrain from deleting them after uploading to FastPix.

Check if media is ready

After initiating thePOST request, FastPix initiates the download and processing of the video content. This operation is generally completed within seconds for smaller-sized files, but larger files or slower internet connections might extend this duration to several minutes.

After the video is fully processed and ready for playback, the media status changes to "ready". It is essential to wait until this status update before attempting to play the video.

For timely updates on media status changes, the best way is through webhooks. FastPix can send over a webhook notification as soon as the asset is ready. (Refer to the webhooks guide for more details.)

Watch your video

To initialize playback of the media, you can insert the playbackId received from the API response or from the dashboard in the stream URL below.

https://stream.fastpix.io/{PLAYBACK_ID}.m3u8

You can use this URL (with .m3u8 extension) in other video players as per your use case.

To directly stream your video on a browser, you can also use the playback stream URL which is sharable. Simply preview your video by adding the playbackId to the stream URL.

 https://play.fastpix.io/?playbackId=d983edb7-c672-4474-8e41-adc8d4d83b05

FastPix Player integration with HTML

You can integrate uploaded videos in FastPix Player which is built-in with video data tracking to enhance your application’s media experience.

<script src="https://cdn.jsdelivr.net/npm/@fastpix/fp-player@<fp-player-version>/dist/player.js"></script>  
 
<fastpix-player  
    playback-id="{PLAYBACK_ID}"  
</fastpix-player>

In the HTML snippet replace <fp-player-version> with the version of the player to activate the player functionality.

Refer to the player guide for more details on integrating with the FastPix video player. You can further customize your player interface and video playback experience as per your requirements.

After you have successfully implemented the integration, connect FastPix Video Data with your player to monitor playback performance.

Manage your media

Upload and playback of your video is just one part of geting started. To build video effectively into your product, you need other functionalities. After you have already added media files into your FastPix workspace, the following endpoints would come in handy: