▣ FILE CONVERSION

Convert Video Formats API

What it does

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

It accepts video for multipart uploads or video_url for remote files, plus output_format. Supported output formats are mp4, mkv, avi, mov, flv, 3gp, and webm. The API is straightforward whether you want to upload directly and download the result, or hand off a cloud URL and retrieve a signed link.

Use Video Format Converter when you need to normalize user-uploaded media, prepare assets for a player that only accepts a specific container, or move videos between storage systems without building conversion logic yourself.

Responses are minimal and easy to integrate: the link-based endpoints return a data field with a signed URI, while the download endpoints return the converted file as binary data.

▣ ENDPOINT 01 / 04

POST

Convert video format (upload → cloud link)

https://api.eu.apyverse.com/apyhub/video-convert/multi-part/link

QUICKSTART

GUIDE

Quickstart

Upload a video file and choose an output format to get a signed download link back.

curl -X POST "https://api.eu.apyverse.com/apyhub/video-convert/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

Converts an uploaded video file to the requested output format and returns a time-limited signed URL for downloading the converted file.

Request Body

Parameter	Type	Mandatory	Description
video	String	Yes	Video file to convert. Binary upload.
output_format	ENUM	Yes	Target format for the converted video. Allowed values: `mp4`, `mkv`, `avi`, `mov`, `flv`, `3gp`, `webm`.

Response

Returns a JSON object with a data string field containing a URI. The data value is a time-limited signed URL for downloading the converted video.

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 02 / 04

POST

Convert video format (URL → download)

https://api.eu.apyverse.com/apyhub/video-convert/url/download

QUICKSTART

GUIDE

Quickstart

Convert a video from a URL into your chosen output format.

curl -X POST "https://api.eu.apyverse.com/apyhub/video-convert/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 binary file data for the converted video.

(binary file)

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 available at a URL into the requested output format and returns the converted file as a binary response. The request body includes the source video_url and the target output_format.

Request Body

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

Response

Returns a binary file containing the converted video.

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ ENDPOINT 03 / 04

POST

Convert video format (URL → cloud link)

https://api.eu.apyverse.com/apyhub/video-convert/url/link

QUICKSTART

GUIDE

Quickstart

Convert a video from a URL into the selected output format.

curl -X POST "https://api.eu.apyverse.com/apyhub/video-convert/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 — a time-limited signed URL for downloading the converted video.

{
  "data": "https://example.com/download/video-converted.mp4?signature=..."
}

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 a cloud download link. The request body must include the source video_url and the target output_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 URI. The data value is 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

—

▣ ENDPOINT 04 / 04

POST

Convert video format (upload → download)

https://api.eu.apyverse.com/apyhub/video-convert/multi-part/download

QUICKSTART

GUIDE

Quickstart

Upload a video file and choose the output container format to download the converted file.

curl -X POST "https://api.eu.apyverse.com/apyhub/video-convert/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 containing the converted video download.

<converted video file>

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 from one supported container format to another and returns the converted file as binary data. The request must include the source video and the desired output container format.

Request Body

Parameter	Type	Mandatory	Description
video	String	Yes	Video file uploaded as binary. Supported input containers: `.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 containing the converted video. The success response is a raw binary payload, not a JSON object.

Parameter	Type	Mandatory	Description
binary data	String	Yes	The converted video file returned by the endpoint.

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.

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