# Video to GIF

Turn a video clip into an animated GIF with good colours, at the size, frame rate and length you choose.

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

## 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

- `video` (required, file, a file reference such as `DROP_ID/f1`, accepts video): The video to turn into a GIF.
- `start` (optional, number, default `0`, range 0..): Where the GIF begins, in seconds from the start of the video.
- `duration` (optional, number, range 0.1..30): Length of the GIF in seconds. Up to 30; left empty, the video is used to its end.
- `width` (optional, integer, default `480`, range 16..1280): Width of the GIF in pixels. The height follows. A video is never made larger.
- `fps` (optional, integer, default `10`, range 1..30): Frames per second. 10 to 15 is smooth enough for most GIFs; fewer makes a smaller file.
- `colors` (optional, integer, default `256`, range 2..256): Number of colours in the palette. Fewer colours make a smaller file.
- `dither` (optional, string, one of `smooth`, `pattern`, `fine`, `none`, default `"smooth"`): How missing colours are imitated: smooth, pattern (smallest file), fine or none.
- `loop` (optional, boolean, default `true`): Play the GIF again and again. Turn off to play it once.

## Example 1: A whole short clip as a GIF

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

```json
{"input":{"video":"DROP_ID/f1","width":240},"wait":30}
```

## Example 2: Two seconds, small file

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

```json
{"input":{"video":"DROP_ID/f1","start":1,"duration":2,"fps":8,"colors":64,"dither":"pattern"},"wait":30}
```

**Why is my GIF file so large?** GIF is an old format that stores every frame with at most 256 colours and weak compression. Lower the width, the frame rate or the length, or use an animated WebP, which is often several times smaller.

**How long can the GIF be?** Up to 30 seconds. From a longer video, set start and duration to pick the part.

**Does the GIF have sound?** No. GIF cannot hold sound.
