适应 Gemini 视频限制：用 FFmpeg 压成 1fps

968 字

5 分钟

适应 Gemini 视频限制：用 FFmpeg 压成 1fps

2025-01-15

技术

FFmpeg

/

Gemini

/

视频处理

/

API

问题 API 的视频限制让人头疼#

Google 的 Gemini API 对视频上传有几条硬性规定:

文件大小不能超过 100MB
视频时长不能超过 1 小时
不能上传有版权的内容

前两条是技术限制,第三条是法律红线。如果你手上有个 200MB 的录屏或者 2 小时的会议记录,想让 Gemini 帮你分析,直接上传肯定过不去。

IMPORTANT
这些限制适用于 Gemini API 的文件上传功能。如果你用的是 Gemini 的其他接口或者 Google AI Studio,限制可能不一样。

有个简单粗暴的办法:把视频压小。

解决方案降帧率#

FFmpeg 是个命令行工具,专门处理音视频。它能把视频的帧率降到 1fps(每秒 1 帧),把原本流畅的视频变成”幻灯片”模式。

最简单的命令#

1
ffmpeg -i input.mp4 -r 1 output.mp4

-r 1 就是把帧率设成 1fps。视频内容还在,只是动作变成了一帧一帧的静态画面。

批量处理多个视频#

如果你有一堆视频要处理,可以用 shell 循环:

1
for f in *.mp4; do
2
    ffmpeg -i "$f" -r 1 "1fps_$f"
3
done

这会把当前目录下所有 .mp4 文件都转成 1fps 版本,文件名前面加上 1fps_。

在 macOS 上用硬件加速(如果你有 M 系列芯片)#

macOS 的 M1/M2/M3/M4 芯片有硬件编码器,能让 FFmpeg 跑得更快。但你得用 Apple 的 VideoToolbox,不能用常见的 libx264。

第一次尝试:复制了网上的命令结果报错#

我一开始试了这个:

1
for f in *.mp4; do
2
  ffmpeg -y -i "$f" \
3
    -r 1 \
4
    -an \
5
    -preset medium -crf 28 \
6
    -c:v h264_videotoolbox \
7
    "${f%.mp4}-1fps.mp4"
8
done

结果 FFmpeg 直接炸了:

1
Error setting bitrate property: -12900
2
Error while opening encoder - maybe incorrect parameters

问题在哪#

VideoToolbox 不认 -preset 和 -crf。这俩是 libx264 的参数,硬件编码器根本不支持。

VideoToolbox 的规则很简单:

不支持 CRF(恒定质量因子)
不支持 x264 的 preset
只能用码率(-b:v)或者质量模式(-q:v)

正确的命令(用码率控制)#

1
for f in *.mp4; do
2
  ffmpeg -y -i "$f" \
3
    -r 1 \
4
    -an \
5
    -c:v h264_videotoolbox \
6
    -b:v 2M \
7
    "${f%.mp4}-1fps.mp4"
8
done

-b:v 2M 是设定码率为 2Mbps。你可以根据需要调高或调低。

或者用质量模式#

1
for f in *.mp4; do
2
  ffmpeg -y -i "$f" \
3
    -r 1 \
4
    -an \
5
    -c:v h264_videotoolbox \
6
    -q:v 50 \
7
    "${f%.mp4}-1fps.mp4"
8
done

-q:v 50 是质量参数,范围大概是 30-60,数字越小质量越好。

如果你还想保留音频#

上面的命令都用了 -an,意思是”删掉音频”。如果你想保留音频,去掉 -an 然后加上 AAC 编码:

1
for f in *.mp4; do
2
  ffmpeg -y -i "$f" \
3
    -r 1 \
4
    -c:v h264_videotoolbox -q:v 50 \
5
    -c:a aac -b:a 128k \
6
    "${f%.mp4}-1fps.mp4"
7
done