▣ FILE CONVERSION · FILE MANIPULATION

Convert Video Formats API

Hosted on ApyHub

What it does

Video Format Converter changes a video from one container format to another. Send either a video URL or a binary video upload, choose an output format, and get back either a downloadable file or a time-limited signed URL.

Use the URL-based endpoints when the source video is already hosted elsewhere. Provide video_url and output_format, where output_format can be mp4, mkv, avi, mov, flv, 3gp, or webm. The response is either a binary download or a data field containing a signed URI for cloud download.

Use the upload endpoints when you already have the file in your application. Send video as binary content plus the same output_format value. Depending on the route, you receive the converted file directly or a signed download link.

This is a good fit for media pipelines, CMS ingest, and backend jobs that need to normalize video assets before storage, playback, or distribution.

▣ ENDPOINT 01 / 04

POST

Convert video format (URL → cloud link)

http://localhost:8080/apyhub/convert-video-formats/url/link

QUICKSTARTGUIDE

Quickstart

Convert a video from a direct URL to MP4 by sending the source URL and desired output format.

curl -X POST "http://localhost:8080/apyhub/convert-video-formats/url/link" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://example.com/video.mp4",
    "output_format": "mp4"
  }'

What you'll get back

Returns a JSON object with a data string field containing a time-limited signed URL for download.

{
  "data": "https://example.com/signed-download-url"
}

TRY ITLIVE · 550 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Converts a video from the source URL you provide into the requested output format and returns a time-limited signed download URL. The request body includes the source video URL and the target format.

Request Body

Parameter	Type	Mandatory	Description
video_url	String	Yes	Source video URL. Must be a valid URI.
output_format	ENUM	Yes	Target video format. Allowed values: `mp4`, `mkv`, `avi`, `mov`, `flv`, `3gp`, `webm`.

Response

Returns a JSON object with a data string field containing a time-limited signed URL for download.

Parameter	Type	Mandatory	Description
data	String	No	Time-limited signed URL for download. Must be a valid URI.

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ ENDPOINT 02 / 04

POST

Convert video format (upload → download)

http://localhost:8080/apyhub/convert-video-formats/multi-part/download

QUICKSTARTGUIDE

Quickstart

Download a converted video file by uploading your source video and choosing an output format.

curl -X POST "http://localhost:8080/apyhub/convert-video-formats/multi-part/download" \
  -H "apy-token: $APY_TOKEN" \
  -F "video=@/path/to/video.mp4" \
  -F "output_format=mp4"

What you'll get back

Returns a binary file stream, not a JSON object. The response body is the converted video file in the requested format.

TRY ITLIVE · 550 ATOMS

API key

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.

About this endpoint

What it does

Converts an uploaded video file to a different container format and returns the converted file as a binary response.

Request Body

Parameter	Type	Mandatory	Description
video	String	Yes	Video file upload. Must be binary data. Supported input files: `.mp4`, `.mkv`, `.avi`, `.mov`, `.flv`, `.3gp`, `.webm`.
output_format	ENUM	Yes	Desired output container format. Allowed values: `mp4`, `mkv`, `avi`, `mov`, `flv`, `3gp`, `webm`.

Response

Returns a binary file response containing the converted video. The output is a raw binary stream, not a JSON object.

Parameter	Type	Mandatory	Description
binary response	String	Yes	Converted video file content returned as binary data.

Body

Name

Type

Description

bodyREQUIRED

object

—

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

▣ ENDPOINT 03 / 04

POST

Convert video format (upload → cloud link)

http://localhost:8080/apyhub/convert-video-formats/multi-part/link

QUICKSTARTGUIDE

Quickstart

Upload a video file and choose the target format to get a signed download link.

curl -X POST "http://localhost:8080/apyhub/convert-video-formats/multi-part/link" \
  -H "apy-token: $APY_TOKEN" \
  -F "video=@/path/to/video.mp4" \
  -F "output_format=mp4"

What you'll get back

Returns a JSON object with a data string field containing a time-limited signed URL for download.

{
  "data": "https://example.com/signed-download-url"
}

TRY ITLIVE · 550 ATOMS

API key

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.

About this endpoint

What it does

Uploads a video file and returns a time-limited signed download URL for the converted video in the requested output format.

Request Body

Parameter	Type	Mandatory	Description
video	String	Yes	Video file to upload as binary data.
output_format	ENUM	Yes	Desired output format. Allowed values: `mp4`, `mkv`, `avi`, `mov`, `flv`, `3gp`, `webm`.

Response

Returns a JSON object with a data string field containing a URI — a time-limited signed URL for download.

Parameter	Type	Mandatory	Description
data	String	No	Time-limited signed URL for download.

Body

Name

Type

Description

bodyREQUIRED

object

—

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

▣ ENDPOINT 04 / 04

POST

Convert video format (URL → download)

http://localhost:8080/apyhub/convert-video-formats/url/download

QUICKSTARTGUIDE

Quickstart

Convert a video from a URL into the format you choose.

curl -X POST "http://localhost:8080/apyhub/convert-video-formats/url/download" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://assets.apyhub.com/samples/sample.mp4",
    "output_format": "mp4"
  }'

What you'll get back

Returns the converted file as binary data (string with format: "binary"), so the response is the video content itself rather than JSON.

TRY ITLIVE · 550 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Converts a video from a source URL into the requested output format and returns the resulting file as binary content. The request body must include the source video_url and the desired output_format.

Request Body

Parameter	Type	Mandatory	Description
video_url	String	Yes	Source video URL. Must be a valid URI.
output_format	ENUM	Yes	Desired output format. Allowed values: `mp4`, `mkv`, `avi`, `mov`, `flv`, `3gp`, `webm`.

Response

Returns a binary file stream containing the converted video in the requested format.

Parameter	Type	Mandatory	Description
binary	String	Yes	The converted video file returned as binary content.

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ 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.