gemini-omni-video-to-sticker-gif

name	gemini-omni-video-to-sticker-gif
description	从视频片段裁剪缩放变速以制作GIF动态表情
license	Apache-2.0
author	github/antigravity
depends_on_skill	[]
depends_on_binary	["ffmpeg","ffprobe","python3"]

技能：gemini-omni-video-to-sticker-gif

概述

此技能专门用于将任意视频（如 MP4）转换为高品质的 GIF 动态表情包。在制作微信表情包等场景下，它提供了从“坐标校准”到“动图生成”的完整工作流。支持在截图中绘制红黄相间的像素坐标刻度（精确到 50px），帮助用户精确确定裁剪范围。

关键词: 视频转GIF, 微信表情包, 坐标定位, GIF加速, 帧定格, ffmpeg

何时使用此技能

• 当您想将一段视频转换成 GIF 表情包，但不确定具体的裁剪坐标时。
• 当您需要精确定位视频中某个主体的坐标，想生成一张带有像素尺度的预览图时。
• 当您需要调整 GIF 速度（如 1.5 倍速），或者想让 GIF 最后一帧定格一段时间（如定格 0.4 秒）时。

目录结构

gemini-omni-video-to-sticker-gif/
├── SKILL.md
└── scripts/
    └── video_to_gif.py   # 核心处理脚本

参数说明

脚本 video_to_gif.py 接收以下参数：

• video_path (位置参数): 输入视频文件的绝对路径。
• -o, --output: 输出 file 路径。如果是 --grid 模式，输出为 PNG 预览图；否则输出为 GIF 动图。
• --ss: 截取起始时间（例如 2.5，单位为秒，默认为 0.0）。
• -t, --duration: 截取的时长（例如 3.5，单位为秒）。
• --to: 截取的结束时间（例如 6.0，单位为秒）。如果提供了 --to，会自动计算时长 duration = to - ss。
• --crop: 裁剪区域。支持以下两种格式：
  • w:h:x:y (FFmpeg 标准格式，如 700:700:292:10)
  • x,y,w,h (如 292,10,700,700 或 xy292x10 wh700x700 格式)
• --scale: 输出尺寸（例如 600:600，默认为 600:600）。
• --speed: 播放速度倍数（例如 1.5，默认为 1.0，大于 1.0 为加速，小于 1.0 为减速）。
• --freeze: 最后一帧定格时长（例如 0.4，单位为秒，默认为 0.0，即不定格）。
• --grid: 启用网格模式。开启后不会生成 GIF，而是提取 --ss 时间点的一帧，并在其上叠加像素坐标刻度（红线代表 100px，黄虚线代表 50px），用于精确定位。

使用示例

1. 提取并生成带刻度的坐标参考图

如果您不确定坐标，先生成一张带有坐标网格 of 预览帧（第 2.0s 处）：

python3 <path_to_skill>/scripts/video_to_gif.py /path/to/video.mp4 --ss 2.0 --grid -o /path/to/preview_grid.png

2. 生成 1.5 倍速、无定格的表情包

根据预览图确定的坐标 x=352, y=39, w=630, h=630，截取 2.5s - 6.0s 视频段，制作 1.5 倍速表情包：

python3 <path_to_skill>/scripts/video_to_gif.py /path/to/video.mp4 --ss 2.5 --to 6.0 --crop 630:630:352:39 --speed 1.5 -o /path/to/output.gif

3. 生成 1.2 倍速、最后一帧定格 0.4 秒的表情包

python3 <path_to_skill>/scripts/video_to_gif.py /path/to/video.mp4 --ss 2.2 --to 6.2 --crop 700:700:319:10 --speed 1.2 --freeze 0.4 -o /path/to/output_freeze.gif

常见陷阱与注意事项

1. 依赖项: 系统必须安装有 ffmpeg 和 ffprobe，并已加入环境变量。
2. 裁剪区域越界: 填写的 x + w 或 y + h 不能超出视频原始的分辨率，否则 ffmpeg 会报错。可以使用 ffprobe 先查看视频原始分辨率，或直接参考生成的 --grid 图像的边缘刻度。
3. 微信表情包大小限制: 微信自定义表情大小限制通常为 5MB（有些老版本限制更低）。如果生成的 GIF 太大，建议通过减小时长、调低帧率或缩放尺寸（例如从 600x600 缩小到 300x300）来控制文件大小。