🧩

Media Convert

Convert a remote video or audio file to a different format.

GET 15 credits /v1/convert/media

curl -OJ "https://convert.toolkitapi.io/v1/convert/media?url=https://toolkitapi.io/input.mov&source_format=mov&target_format=mp4"

import httpx

resp = httpx.get(
    "https://convert.toolkitapi.io/v1/convert/media?url=https://toolkitapi.io/input.mov&source_format=mov&target_format=mp4",
)
print(resp.json())

const resp = await fetch("https://convert.toolkitapi.io/v1/convert/media?url=https://toolkitapi.io/input.mov&source_format=mov&target_format=mp4", {
});
const data = await resp.json();
console.log(data);

# See curl example

Response 200 OK

Binary media file streamed as a download (Content-Type depends on target_format)

Try It Live

Description

Convert a remote video or audio file to a different format.

How to Use

1

1. Host the source file at a publicly-reachable HTTPS URL.

2

2. GET this endpoint with `url`, `source_format`, and `target_format`.

3

3. Stream the response to disk or to your user's browser.

About This Tool

Converts a remote media file — video or audio — to a different container/codec via ffmpeg. The converted file is streamed back as a download with the appropriate `Content-Type` and `Content-Disposition` headers.

Check `/v1/convert/supported-media-formats` first to confirm your source/target pair is supported. For long-running conversions (large videos), this endpoint may take significant time — consider async jobs for files over a few tens of megabytes.

Why Use This Tool

Video normalization — Convert diverse uploads to a canonical `mp4` for playback
Audio transcoding — Move legacy `wav` archives to space-efficient `mp3`/`ogg`
GIF creation — Turn short `mp4` clips into shareable animated GIFs
Podcast ingestion — Standardize incoming audio into a single codec

Frequently Asked Questions

What's the size limit?

The synchronous endpoint accepts inputs up to the server-configured limit (typically ~200 MB). Use async jobs for larger files.

Can I customize encoding parameters?

Not via this endpoint — defaults are tuned for balanced quality and file size. Custom bitrates, resolutions, and codecs require the advanced media job API.

Is the source URL fetched server-side?

Yes. Private or auth-protected URLs are not supported.

Start using Media Convert now

Get your free API key and make your first request in under a minute.

Get Free API Key View Docs