MediaTofuVideo to GIF API
Video to GIF API
POST /v1/tools/gif with an input URL or file id to turn a section of video into an animated GIF. Set start, duration, width, and fps. Each job runs in its own sandbox; short jobs can return their result in the same request with ?wait=25.
Example
curl "https://api.mediatofu.com/v1/tools/gif?wait=25" \
-H "Authorization: Bearer $MEDIATOFU_KEY" \
-d '{ "input": "https://example.com/clip.mp4", "start": 0, "duration": 3, "width": 480, "fps": 12 }'Same auth and wait behavior as the other tools. Poll GET /v1/jobs/:id when you leave wait off.
Options
start and duration pick the section of the source. width scales the GIF. fps sets the frame rate. Omit options you do not need and the tool uses its defaults.
Pricing
Free: $0, 5 minutes of compute a month, jobs up to 1 minute, inputs up to 50 MB, 1 job at a time. Pay per use: $0.024 per compute minute, billed by the second, no monthly fee. Jobs up to 5 minutes, inputs up to 2 GB, 3 jobs at once. Starter: $9/month includes 600 minutes, then $0.015 a minute. Jobs up to 1 minute, inputs up to 500 MB. Pro: $19/month includes 1,500 minutes, then $0.0127 a minute. Jobs up to 10 minutes, inputs up to 2 GB.
Questions
Can I use a raw FFmpeg palettegen pipeline instead?
Yes. POST /v1/run accepts your own ffmpeg_command with {{in}} and {{out}} placeholders when you need full control.
How do I get the result?
Add ?wait=25 and a short job can return its result in the same request. Short jobs typically take about 5–15 seconds including container start. 25 seconds is the longest wait. Otherwise you get a job id to check with GET /v1/jobs/:id, or on a paid plan you can pass webhook_url and we POST the result to you.
Do failed jobs cost anything?
A failure on our side is never charged, and neither is an input we couldn't download or one over your plan's size limit. If your command runs and FFmpeg exits with an error, or the job reaches your plan's length limit, the seconds it used count.
What does MediaTofu cost?
Free: $0, 5 minutes of compute a month, jobs up to 1 minute, inputs up to 50 MB, 1 job at a time. Pay per use: $0.024 per compute minute, billed by the second, no monthly fee. Jobs up to 5 minutes, inputs up to 2 GB, 3 jobs at once. Starter: $9/month includes 600 minutes, then $0.015 a minute. Jobs up to 1 minute, inputs up to 500 MB. Pro: $19/month includes 1,500 minutes, then $0.0127 a minute. Jobs up to 10 minutes, inputs up to 2 GB.