Compress Video

Introduction

The Compress Video API is designed to reduce the file size of large video files without significantly affecting quality. Handling raw video can be expensive in terms of storage and bandwidth. This API provides an efficient way to optimize videos for faster streaming, reduced costs, and improved delivery — all while hosting compressed outputs securely in the cloud.

Key Features

Efficient Compression: Reduce video file sizes with minimal quality loss.
Multiple Quality Modes: Choose from compression levels like HIGH, MEDIUM, or LOW.
Cloud Hosting: Compressed videos hosted securely and accessible via a URL.
TTL (Time-to-Live): Define how long the compressed video should be stored.

API details

Endpoint

POST https://api.signzy.app/api/v3/converters/compress-video

POST https://api-preproduction.signzy.app/api/v3/converters/compress-video

Request Headers

Name	Required	Description
Content-Type	Mandatory	Type of request body. Must be `application/json`.
Authorization	Mandatory	Bearer token (API key) for authentication.

Request body parameters

Parameter	Required	Description
url	Mandatory	Publicly accessible URL of the video to compress
quality	Mandatory	Compression quality. Accepted values: `HIGH`, `MEDIUM`, `LOW`
ttl	Optional	Time-to-live for the compressed video (e.g., `1 day`, `7 days`)

{
  "url": "https://persist.signzy.tech/api/files/597821255/download/9bb830a13f82408d9f100b9f35325460c8caecd345894f48a0e7d015de5af708.mp4",
  "quality": "HIGH",
  "ttl": "1 day"
}

Code Samples

curl --location 'https://api-preproduction.signzy.app/api/v3/converters/compress-video' \
--header 'Authorization: <auth-key>' \
--header 'Content-Type: application/json' \
--data '{
    "url": "https://persist.signzy.tech/api/files/597821255/download/9bb830a13f82408d9f100b9f35325460c8caecd345894f48a0e7d015de5af708.mp4",
    "quality": "HIGH",
    "ttl": "1 day"
}'

Response body parameters

Parameter	Data Type	Description
result	Object	The root object containing the result.
compressedVideo	String	Public URL of the compressed image

{
    "result": {
        "compressedVideo": "https://example.com/api/files/download/abc.mp4"
    }
}