Sada Files
  1. Developers
  2. Tool endpoints

Compress Video to Target Size API

Compress video to fit exact upload limits for WhatsApp (16 MB), Discord (25 MB), Email (10 MB), or custom MB targets.

Environment

EnvironmentBase URL
Productionhttps://api.sadafiles.com/v1

There is one environment and no sandbox, so every request here is real and counts toward your limits.

Request

POSThttps://api.sadafiles.com/v1/tools/compress-video-to-size
Content type
multipart/form-data
Auth
X-API-Key with tools:run
Accepts
mp4, webm, mov, mkv, avi
Files per request
1
Largest file
2 GB
Job timeout
300 s
Rate weight
2 units

Parameters

Send these as a JSON string in the options form field. Anything else is rejected.

NameTypeDefaultAllowed
presetstringwhatsapp-16mbwhatsapp-16mb, discord-25mb, email-10mb, custom
customTargetMbnumber16min 1, max 500, MB
maxResolutionstring720p1080p, 720p, 480p, original

Response

StatusBodyWhen
201mp4The run finished within 60 seconds
202Job summary JSONStill running; poll the job
4xx, 5xxError JSONSee error codes

A file response carries X-Sada-Job and X-Sada-Expires-At. For long work, post to /v1/tools/compress-video-to-size/jobs instead. See jobs and webhooks.

Try it yourself!

Pick a file, set the options and run a real request with your key. The code follows your changes.

Headers

You need a free key to run this request. Sign in and create a key.

Body

curl -X POST "https://api.sadafiles.com/v1/tools/compress-video-to-size" \  -H "X-API-Key: $SADAFILES_API_KEY" \  -F "files[]=@input.mp4" \  -o output.mp4

What's next?