Конвертация видео в GIF через REST API
Создавайте анимированные GIF из видеофайлов автоматически. Поддержка двухпроходного алгоритма для максимального качества, управление FPS и разрешением через API-параметры.
Где используется
Примеры запросов
Быстрая конвертация (один запрос)
curl -X POST https://ffmpeg-api.ru/api/jobs \
-H "X-API-Key: YOUR_API_KEY" \
-F "file=@clip.mp4" \
-F 'args=[-vf,scale=480:-1:flags=lanczos,-r,12,-f,gif]' \
-F "output_name=animation.gif"Двухпроходный метод (максимальное качество цветопередачи)
# Двухпроходный метод — высокое качество GIF
# Шаг 1: создать палитру
curl -X POST https://ffmpeg-api.ru/api/jobs \
-H "X-API-Key: YOUR_API_KEY" \
-F "file=@clip.mp4" \
-F 'args=[-vf,fps=12\,scale=480:-1:flags=lanczos\,palettegen,-f,png]' \
-F "output_name=palette.png"
# Шаг 2: применить палитру (файл palette.png загружается вторым входом)
curl -X POST https://ffmpeg-api.ru/api/jobs \
-H "X-API-Key: YOUR_API_KEY" \
-F "file=@clip.mp4" \
-F "file=@palette.png" \
-F 'args=[-i,input1,-lavfi,fps=12\,scale=480:-1:flags=lanczos[x];[x][1:v]paletteuse,-f,gif]' \
-F "output_name=hq.gif"Параметры GIF
| Параметр | Описание | Рекомендация |
|---|---|---|
| -r 10 | 10 кадров в секунду | Мессенджеры, мемы |
| -r 15 | 15 кадров в секунду | Плавная анимация |
| -r 24 | 24 кадра — как в кино | Максимальная плавность |
| -vf scale=480:-1 | 480px шириной, авто высота | Мессенджеры |
| -vf scale=320:-1 | 320px — минимальный размер | Превью |
| -vf scale=800:-1 | 800px — большой GIF | Документация |
| -ss 0 -t 3 | Первые 3 секунды | Короткие GIF |
Другие возможности API
Часто задаваемые вопросы
Ответы на популярные вопросы
Как сделать GIF меньшего размера?+
Уменьшите разрешение (-vf scale=480:-1), снизьте FPS (-r 10) и сократите количество цветов в палитре. Двухпроходная генерация через palettegen/paletteuse даёт наилучшее качество при минимальном размере.
Почему GIF получается с плохим качеством?+
GIF ограничен 256 цветами. Для лучшего качества используйте двухпроходный метод: сначала создайте палитру (palettegen), затем примените её (paletteuse). Без этого ffmpeg использует стандартную палитру.
Какой максимальный FPS для GIF?+
Технически GIF поддерживает до ~50 FPS, но оптимально 10–15 FPS — файл меньше, анимация плавная. Для мемов и превью 10 FPS достаточно.
Можно ли вырезать фрагмент видео для GIF?+
Да. Используйте -ss для начала и -t для длительности: -ss 00:00:05 -t 3 вырежет 3 секунды начиная с 5-й. Чем короче фрагмент — тем меньше GIF.
Чем GIF хуже WebM для анимации на сайте?+
GIF значительно больше по размеру (в 5–10 раз) и имеет ограничение в 256 цветов. WebM через тег <video autoplay loop muted> — лучшая альтернатива для сайтов. GIF удобен для мессенджеров и сервисов без поддержки видео.
Готовы попробовать?
Бесплатный тариф — без карты. Первые задачи через API уже через минуту.