apyhub
Back

Compress Video API

What it does

Video Compressor lets you send a video file and get a compressed version back. The endpoint accepts a binary file upload up to 100 MB, plus an optional targetPercent value between 0 and 1 to control the approximate output size. If you leave targetPercent out, the default is 0.5, which targets about half the original size.

Use it when you need to shrink uploads for faster delivery, lower storage costs, or fit videos into product workflows with size limits. You keep the compression step in your own application logic while delegating the actual file processing to a dedicated API endpoint.

The response schema is empty, so the service returns a successful result without additional documented fields. That makes it suitable for pipelines where the main requirement is to complete compression and move on to the next step.

POST
Video: compress
https://api.eu.apyhub.com/freedailypro/compress-video-api/video-compress

QUICKSTART

GUIDE

Quickstart

Compress a video by uploading the file as multipart form data.

curl -X POST "https://api.eu.apyhub.com/freedailypro/compress-video-api/video-compress" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/video.mp4"

What you'll get back

The compressed video as a binary file.

TRY ITLIVE · 10 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.
body*
The video file. Up to 100 MB.
Between 0 and 1, exclusive: 0.5 (default) targets about half the original size.

About this endpoint

What it does

Compresses an uploaded video to a smaller file size and returns the compressed video as binary data.

Request Body

ParameterTypeMandatoryDescription
fileFileYesThe video file. Up to 100 MB.
targetPercentNumberNoTarget size as a fraction of the original, between 0 and 1 (exclusive). Defaults to 0.5, about half the original size.

Response

Returns the compressed video as a binary file in the response body.

ParameterTypeDescription
Binary fileFileThe compressed video.

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.