Progress Bar

POST

Add an animated progress bar to a video. Supports two styles: 'grow': bar fills left-to-right over the video duration 'shrink': bar starts full and shrinks (countdown, like social media stories) Example: {"url": "https://cdn.example.com/video.mp4", "style": "shrink", "color": "00ff00", "position": "top"}

Guide

Overview

Add an animated progress bar to a video.

Supports two styles:

'grow': bar fills left-to-right over the video duration 'shrink': bar starts full and shrinks (countdown, like social media stories) Example: {"url": "https://cdn.example.com/video.mp4", "style": "shrink", "color": "00ff00", "position": "top"}

Video Tutorial

Example Request Bodies

Bar fills left to right

{
  "url": "https://cdn.example.com/video.mp4"
}

Grow bar at top

{
  "url": "https://cdn.example.com/video.mp4",
  "color": "ffffff",
  "style": "grow",
  "height": 4,
  "opacity": 0.7,
  "padding": 60,
  "bg_color": "000000",
  "position": "top"
}

Grow bar at bottom

{
  "url": "https://cdn.example.com/video.mp4",
  "color": "1da1f2",
  "style": "grow",
  "height": 10,
  "opacity": 1,
  "padding": 60,
  "bg_color": "0d0d0d",
  "position": "bottom"
}

Shrink — Bar drains right to left

{
  "url": "https://cdn.example.com/video.mp4",
  "color": "00ff00",
  "style": "shrink",
  "height": 5,
  "opacity": 1,
  "padding": 60,
  "bg_color": "333333",
  "position": "top"
}

YouTube Shorts countdown — bottom, red, thick

{
  "url": "https://cdn.example.com/video.mp4",
  "color": "ff0000",
  "style": "shrink",
  "height": 8,
  "opacity": 0.9,
  "padding": 60,
  "bg_color": "1a1a1a",
  "position": "bottom"
}

Green border grow — streaming/game content

{
  "url": "https://cdn.example.com/video.mp4",
  "color": "00ff00",
  "style": "border_grow",
  "height": 8,
  "opacity": 0.9,
  "bg_color": "111111"
}

Red border shrink — urgency/timer feel

{
  "url": "https://cdn.example.com/video.mp4",
  "color": "ff0000",
  "style": "border_shrink",
  "height": 8,
  "opacity": 0.95,
  "bg_color": "1a1a1a"
}

Example Response

{
  "job_id": "f595b9ad-1e15-4452-b7c2-8f8ff09c0a34",
  "status": "pending",
  "message": "Job created. Poll status_url for progress.",
  "job_type": "caption",
  "result_url": "https://eranol.com/api/v1/ffmpeg/result/f595b9ad-1e15-4452-b7c2-8f8ff09c0a34",
  "status_url": "https://eranol.com/api/v1/ffmpeg/status/f595b9ad-1e15-4452-b7c2-8f8ff09c0a34"
}

Endpoint

Send your requests to the following URL using the specified HTTP method.

POST https://eranol.com/api/v1/ffmpeg/video/progress-bar

Headers

Include the following headers with every request. Your API key is required for authentication.

Content-Type:application/json

x-api-key:YOUR_API_KEY

Request Body

Send the following JSON payload in the request body. Adjust the values to match your use case.

json

{
  "url": "https://cdn.example.com/video.mp4"
}

Parameters

All available options for this endpoint. Required parameters are marked accordingly.

Parameter	Type	Default	Description
url	string	required	Video file URL
style	string	`grow`	Bar style: grow (left→right) or shrink (countdown like stories)
color	string	`white`	Bar color — name or hex
height	int	`4`	Bar height in pixels
position	string	`bottom`	Bar position: top or bottom
opacity	float	`0.8`	Bar opacity (0.0–1.0)

Example Request— Bar fills left to right

Use the following cURL command to make a request to this API endpoint. Replace YOUR_API_KEY with your actual API key from the dashboard.

bash

curl -X POST "https://eranol.com/api/v1/ffmpeg/video/progress-bar" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://cdn.example.com/video.mp4"}'

Example Response

Below is an example of a successful JSON response from this endpoint.

json

{
  "job_id": "f595b9ad-1e15-4452-b7c2-8f8ff09c0a34",
  "status": "pending",
  "message": "Job created. Poll status_url for progress.",
  "job_type": "caption",
  "result_url": "https://eranol.com/api/v1/ffmpeg/result/f595b9ad-1e15-4452-b7c2-8f8ff09c0a34",
  "status_url": "https://eranol.com/api/v1/ffmpeg/status/f595b9ad-1e15-4452-b7c2-8f8ff09c0a34"
}

Response Status

A successful request will return one of the following HTTP status codes.

200 OKRequest was successful and data is returned in the response body.

201 CreatedResource was successfully created.

401 UnauthorizedMissing or invalid API key.

429 Too Many RequestsRate limit exceeded. Try again later.