CONVERTMEPLS

Getting started

Convert your first file with the ConvertMePls API in three requests.

The ConvertMePls API converts files between 69 image, video and audio formats. The flow is always the same: get an upload URL, upload your file, request a conversion, then poll (or receive a webhook) for the result.

Base URL

https://api.convertmepls.com

All requests and responses are JSON unless you are uploading or downloading the file bytes themselves.

Your first conversion

# 1. Ask for a presigned upload URL
curl -X POST https://api.convertmepls.com/uploads \
  -H "authorization: Bearer $CONVERTMEPLS_KEY" \
  -H "content-type: application/json" \
  -d '{"filename":"cat.png","contentType":"image/png","bytes":20480}'
# → { "uploadUrl": "...", "inputKey": "inputs/..." }

# 2. PUT the file bytes to uploadUrl
curl -X PUT "$UPLOAD_URL" --upload-file cat.png

# 3. Request the conversion
curl -X POST https://api.convertmepls.com/conversions \
  -H "authorization: Bearer $CONVERTMEPLS_KEY" \
  -H "content-type: application/json" \
  -d '{"inputKey":"inputs/...","source":"png","target":"webp"}'
# → { "jobId": "..." }

Get the result

Poll the job until it is done, then download from the returned URL:

curl https://api.convertmepls.com/conversions/$JOB_ID \
  -H "authorization: Bearer $CONVERTMEPLS_KEY"
# → { "status": "done", "downloadUrl": "..." }

Prefer not to poll? Register a webhook and we will call you the moment the job finishes.

Next steps