Convert Image API
Convert images between JPG, PNG, WebP, AVIF, GIF, BMP, TIFF, ICO and JPEG XL (HEIC, SVG, TGA and PPM in) — with quality, lossless, background and metadata options, in batch.
Environment
| Environment | Base URL |
|---|---|
| Production | https://api.sadafiles.com/v1 |
There is one environment and no sandbox, so every request here is real and counts toward your limits.
Request
POSThttps://api.sadafiles.com/v1/tools/convert-image
- Content type
- multipart/form-data
- Auth
- X-API-Key with tools:run
- Accepts
- jpg, png, webp, avif, gif, bmp, tiff, svg and 7 more
- Files per request
- 1 to 500
- Largest file
- 2 GB
- Job timeout
- 120 s
- Rate weight
- 2 units
- Web tool
- Use Convert Image without code
Parameters
Send these as a JSON string in the options form field. Anything else is rejected.
| Name | Type | Default | Allowed |
|---|---|---|---|
format | string | png | jpg, png, webp, avif, gif, bmp, tiff, ico, jxl |
quality | integer | 85 | min 1, max 100 |
lossless | boolean | false | — |
backgroundFill for transparency when the target has none | string | #FFFFFF | — |
keepMetadata | boolean | false | — |
icoSizesEvery size is stored in one .ico; sizes larger than the image are skipped | array | 16,32,48,64,128,256 | — |
Response
| Status | Body | When |
|---|---|---|
201 | jpg, png, webp, avif, gif, bmp, tiff, ico and 2 more | The run finished within 60 seconds |
202 | Job summary JSON | Still running; poll the job |
4xx, 5xx | Error JSON | See error codes |
A file response carries X-Sada-Job and X-Sada-Expires-At. For long work, post to /v1/tools/convert-image/jobs instead. See jobs and webhooks.
Also runs on the device
In the web tool and apps, Convert Image can run locally with no upload. The API always processes on the server.
Try it yourself!
Pick a file, set the options and run a real request with your key. The code follows your changes.