Eranol LogoEranol
BlogCommunityDocumentationPricingSign In

General

OverviewGet Started

Universal

Add IntroAdd OutroAudio to VideoBackground AudioCaptions ApiComposeConcatConvert a video file to MP4Convert Audio to Mp3Convert Audio to wavConvert to JPGConvert to WebMConvert to WebPDenoiseEnhanceExtract audio track from a videoExtract images from a videoGenerate a GIF from a videoHighlightsImage TestMergeNotifyOverlayProgress BarReframeRemove SilenceThumbnailTikTokTrimVerifyWatermarkZoom

General

DeleteImage StatusStatusTikTok StatusFFmpeg Results

Need help?

Contact Support

Reframe

POST

Change video aspect ratio / resolution with coloured padding. Takes a video and reframes it to the target width x height. The original video is scaled to fit inside the new dimensions (maintaining aspect ratio) and the remaining space is filled with the chosen background colour. Example — landscape 1280x720 → portrait 1080x1920 with white bars: {"url": "https://cdn.example.com/video.mp4", "width": 1080, "height": 1920, "bg_color": "#ffffff"}

Overview

Change video aspect ratio / resolution with coloured padding.

Takes a video and reframes it to the target width x height. The original video is scaled to fit inside the new dimensions (maintaining aspect ratio) and the remaining space is filled with the chosen background colour.

Example — landscape 1280x720 → portrait 1080x1920 with white bars: {"url": "https://cdn.example.com/video.mp4", "width": 1080, "height": 1920, "bg_color": "#ffffff"}

Endpoint

POST https://eranol.com/api/v1/ffmpeg/video/reframe

Request Body

{
  "url": "https://example.com/",
  "width": 0,
  "height": 0,
  "bg_color": "#000000"
}

Response Example

{
  "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"
}

Error Codes

CodeMeaning
401Missing or invalid API key
402Insufficient credits
422Validation error — check your request body
429Rate limit exceeded — slow down requests
500Internal server error — try again or contact support