Convert a file

POST /api/v1/convert Convert or resize one file. Conversion does not spend credits. It still needs a paid-plan key. Send the bytes, a URL, or a job_id from an earlier call. The call waits until the job finishes unless you send wait=false. Image default is webp. Video default is mp4. Anything else is 400 unsupported_format.

curl -X POST https://mediamonster.app/api/v1/convert \
  -H "Authorization: Bearer mm_live_…" \
  -F "file=@launch-teaser.png" \
  -F "format=webp" \
  -F "width=1280"

{
  "id": "3f1c…",
  "status": "complete",
  "outputs": [
    {
      "name": "launch-teaser.webp",
      "mime": "image/webp",
      "size_bytes": 84213,
      "width": 1280,
      "height": 720,
      "url": "https://…signed…"
    }
  ]
}

Field	Type	What it does
`file`	file	Multipart field name `file`
`url`	string	A public URL instead of `file`
`job_id`	string	Reuse a file the API has already stored
`format`	string	Image: `png`, `jpeg`, `webp`. Video: `mp4`, `webm`
`width`	number	Target width in pixels
`height`	number	Target height in pixels
`aspect`	string	Aspect ratio. Default `original`
`quality`	number	Encode quality. Default `85`
`wait`	boolean	Default `true`. Set `false` to poll `GET /api/v1/jobs/{id}`

Output URLs are signed and expire after ten minutes. Read the job again for fresh ones.

Audio is not converted here. Use audio skills.

Get started

Workbench

Skills

API

Account

Help