FFMPEG API Guide

How do I convert video to GIF with an API?

Convert video URLs into animated GIFs with optional chromakey transparency using FFMPEG API.

Convert Video to GIF

Downloads a video and creates a GIF. Optional chroma key transparency supports solid-color backgrounds such as green screen.

Endpoint: POST /api/convert_video_to_gif

Authentication: send X-API-Key: your_api_key_here.

curl Example

curl -X POST "https://ffmpegapi.net/api/convert_video_to_gif" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "video_url": "https://example.com/clip.mp4",
  "transparent_background": true,
  "chromakey_color": "0x00FF00",
  "fps": 10
}'

Request Body

{
  "chromakey_color": "0x00FF00",
  "fps": 10,
  "transparent_background": true,
  "video_url": "https://example.com/clip.mp4"
}

Success Response

{
  "download_url": "https://ffmpegapi.net/api/storage/clip_abc123.gif",
  "filename": "clip_abc123.gif",
  "message": "Convert Video to GIF completed successfully",
  "success": true
}

Use From AI Agents

Agents can call this workflow from REST using the OpenAPI spec or from the hosted MCP server at https://mcp.ffmpegapi.net/mcp. Keep API keys in request headers, not tool arguments.

FAQ

FFMPEG API exposes POST /api/convert_video_to_gif with controls for transparency, chromakey, frame rate, and output width.

Use async: true for larger media, caption rendering, or jobs likely to exceed a normal HTTP timeout. Poll job status until completion.