# Compress image

Make an image file smaller by re-encoding it at a chosen quality, with an optional maximum width.

- Endpoint: `POST https://setget.net/v1/tools/image-compress` with JSON `{"input": {...}}` (add `"wait": 30` to hold the reply until the job finishes)
- MCP: `run_tool` with `slug` = `image-compress`
- Page: https://setget.net/tools/image-compress

## Files in, files out

This is a file tool. Its file inputs take file references, not file contents and not web addresses.

- Get a reference by uploading: `curl -T FILE https://setget.net/drop/` prints a line `ref  <id>/f1`. Or `POST https://setget.net/v1/drops` with `{"files":[{"name","size"}]}`, PUT the bytes to the returned `upload.url` with the listed headers, and use the file's `ref`. Over MCP use the `drop` tool. A file under about 700 KB can also be sent in place as a `data:<type>;base64,<content>` URI.
- Uploads are at most 100 MB per file, are readable by anyone with the link, and expire (one hour by default). Programs are refused.
- The tool runs as a job. The reply is `{"tool", "ms", "result", "files", "job"}`: `result` is JSON, and every result file comes back in `files` as `{"name", "size", "content_type", "kind", "url", "ref"}`. Download it from `url`, or pass `ref` as the input of another file tool.
- A job still running when the wait ends answers 202 with `job`. Follow it with `GET https://setget.net/v1/jobs/<id>?wait=30`, or stream progress from `GET https://setget.net/v1/jobs/<id>/events` (over MCP: the `job` tool). A person can watch it at `job.url`.

## Inputs

- `image` (required, file, a file reference such as `DROP_ID/f1`, accepts image): The image to compress.
- `quality` (optional, integer, default `75`, range 1..100): From 1 (smallest file) to 100 (best quality). 75 is a good balance for photos. For PNG, values below 100 reduce the number of colours.
- `max_width` (optional, integer, range 1..16000): Shrink the image to this width in pixels if it is wider. Smaller dimensions save the most space.
- `format` (optional, string, one of `jpg`, `png`, `webp`, `avif`): Format of the result. Leave empty to keep JPG, PNG, WebP and AVIF as they are; other formats such as GIF, BMP and TIFF become WebP.

## Example 1: Compress a photo

Upload first. Each placeholder below stands for the reference of one upload: `DROP_ID/f1` = [sample.jpg](https://setget.net/static/samples/sample.jpg).

```json
{"input":{"image":"DROP_ID/f1","quality":60},"wait":30}
```

## Example 2: Smaller and narrower, as WebP

Upload first. Each placeholder below stands for the reference of one upload: `DROP_ID/f1` = [sample.jpg](https://setget.net/static/samples/sample.jpg).

```json
{"input":{"image":"DROP_ID/f1","quality":70,"max_width":320,"format":"webp"},"wait":30}
```

## Example 3: Animated GIF to a smaller animated WebP

Upload first. Each placeholder below stands for the reference of one upload: `DROP_ID/f1` = [sample.gif](https://setget.net/static/samples/sample.gif).

```json
{"input":{"image":"DROP_ID/f1"},"wait":30}
```

**Which quality should I pick?** Start at 75. Photos usually look the same down to about 60. Go to 85 or higher for images with text or sharp edges.

**How is a PNG compressed?** At quality 100 it is repacked with no change to the pixels. Below 100 the colours are reduced to 256 or fewer, which often cuts the size by more than half and suits logos, screenshots and drawings.

**Why did my file get bigger?** It was already compressed harder than the quality you chose. The result reports this; try a lower quality, a max_width, or WebP.

**What saves the most?** Reducing the dimensions with max_width, then switching to WebP or AVIF.
