提取视频缩略图
提取视频缩略图 是有文档说明的 APIAny 免费 API 工具：先在浏览器试用，再用 API 密钥调用同一操作。
在指定视频时间点截取 JPEG 或 WebP 缩略图。
POST /api/free/video-thumbnail来源
本页引用了哪些官方资料？
以下引文来自 APIAny 对照实现的官方 API 文档。
The Fetch API provides an interface for fetching resources (including across the network).
The typical use case for this high speed Node.js module is to convert large images in common formats to smaller, web-friendly JPEG, PNG, WebP and AVIF images of varying dimensions.
The Images API provides several endpoints that let you generate images from text prompts or create edits of existing images.
在线提取视频缩略图
上传、设置、预览与下载都不需要 API Key。
1. 上传与设置
无需 API Key 即可在线处理；只有点击运行后，文件才会发送到本站。
2. 预览与下载
包含预览、文件大小变化和下载按钮
通过 API 接入
仅程序调用需要 API Key；参数、响应和错误信息集中展示。
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。
提取视频缩略图 有哪些使用限制？
在线工具每分钟最多 3 次、每天 30 次；鉴权免费账户为 5 RPM，付费账户为 500 RPM，并在全部免费 API 间共享。
提取视频缩略图 支持哪些输入？
请按参数表提供必填与选填字段；不支持的格式和超出范围的值会被拒绝。
提取视频缩略图 返回什么？
成功请求返回 image 响应；失败时使用上方列出的 HTTP 状态码。