提取视频缩略图

在指定视频时间点截取 JPEG 或 WebP 缩略图。

POST /api/free/video-thumbnail

在线提取视频缩略图

上传、设置、预览与下载都不需要 API Key。

无需登录或 API Key

1. 上传与设置

无需 API Key 即可在线处理；只有点击运行后，文件才会发送到本站。

视频文件 *

点击选择文件，或拖拽到这里MP4 · WebM · MOV · 250 MB只有运行工具时才会上传文件。

时间点（秒）

缩略图宽度

输出格式

填写必填参数后即可运行工具。POST /api/free-online/video-thumbnail

2. 预览与下载

结果将在这里显示

包含预览、文件大小变化和下载按钮

通过 API 接入

仅程序调用需要 API Key；参数、响应和错误信息集中展示。

API 接口

POST /api/free/video-thumbnail

在线使用免 Key；程序调用此接口时需要 APIAny Key。

工作原理

时间点必须位于源视频时长范围内。
缩略图宽度最多为 1920 像素。

响应结果

请求成功后返回 image 类型响应，Content-Type 与本页说明一致。

常见错误

400: 缺少文件或参数、值无效，或者超出页面标注的限制。
401: 程序调用缺少 API Key，或 Key 无效、已停用。
429: 在线或鉴权调用已达到共享限速。

参数与限制

参数	要求	默认值	可用值
`video`视频文件	必填	—	file
`timestamp`时间点（秒）	选填	0	number
`width`缩略图宽度	选填	1280	number
`format`输出格式	选填	webp	webp, jpeg

API 调用示例

下面是用于程序代码的鉴权示例；上方在线 Playground 不会要求或暴露你的 API Key。

curl -X POST "https://apiany.ai/api/free/video-thumbnail" \
  -H "Authorization: Bearer $API_KEY" \
  -F "video=@input.mp4" \
  -F "timestamp=2" \
  --output thumbnail.webp

常见问题

使用提取视频缩略图需要 API Key 吗？

在线 Playground 无需 Key；程序请求请通过 Authorization: Bearer 或 X-API-Key 发送 APIAny Key。