Video Thumbnail

Extract video thumbnails or video metadata at any timestamp with a simple API call.

原始信息汇总

Video Thumbnail API 数据集概述

基本信息

• API名称: Video Thumbnail
• 类别: Media
• 提供者: Sanity187
• 基础URL: https://video-thumbnail-api.p.rapidapi.com
• 版本: 1.0.0 (current)
• 订阅者: 1
• 流行度: 8.9
• 服务等级: 100%
• 延迟: 604ms
• 测试通过率: 83%

定价方案

• BASIC: $0.00 / mo
• PRO: $12.00 / mo
• ULTRA: $39.00 / mo
• MEGA: $99.00 / mo

核心功能

• 从视频的任意时间戳提取高质量缩略图。
• 支持精确的时间戳提取，格式包括标准时间格式（HH:MM:SS）、分秒格式（MM:SS）、仅秒格式（秒或带小数秒）。
• 支持广泛的视频格式：MP4、WebM、MOV、AVI、MKV、FLV、WMV、M4V、3GP。
• 提供灵活的缩略图输出格式：JPEG（默认）、PNG、WebP。
• 支持智能调整缩略图尺寸：可指定宽度、高度或两者。
• 可获取完整的视频元数据，包括时长、分辨率、视频编解码器、帧率、比特率、音频轨道检测。

主要用例

• 视频平台：为视频库、播放列表和搜索结果生成预览缩略图。
• 内容管理：用户上传视频到CMS时自动创建缩略图。
• 社交媒体工具：提取用于社交分享预览和视频亮点的帧。
• 电子商务：为在线商店生成产品视频预览。
• 媒体处理：构建大规模处理视频内容的自动化工作流。
• 教育平台：为课程创建章节缩略图和视频摘要。

端点详情

1. 获取服务信息

• 端点: GET /api/v1/video/info
• 无需认证。
• 响应: 返回支持的格式和限制信息，包括支持的视频格式、输出格式、MIME类型、最大视频大小（100MB）和时间戳格式。

2. 提取缩略图

• 端点: POST /api/v1/video/thumbnail
• 认证: 需要RapidAPI认证头（X-RapidAPI-Key和X-RapidAPI-Host）。
• 两种请求方式:
  • 选项A（JSON Body）: 通过video_url提供视频URL。
  • 选项B（表单数据）: 通过video字段上传视频文件。
• 参数:
  • video_url（字符串）或video（文件）：视频源（二选一）。
  • timestamp（字符串）：提取的时间位置（可选，默认为前10秒内的随机时间戳）。
  • format（字符串）：输出格式，可选jpeg、png、webp（默认jpeg）。
  • width（整数）：调整宽度（可选）。
  • height（整数）：调整高度（可选）。
  • filename（字符串）：自定义输出文件名（可选）。
  • response_type（字符串）：响应类型，可选direct（二进制）或url（预签名URL）（默认direct）。
• 响应:
  • direct：返回二进制图像数据，包含Content-Type和Content-Disposition头。
  • url：返回JSON，包含download_url、filename、format、size_bytes、timestamp、expires_in。

3. 获取视频元数据

• 端点: POST /api/v1/video/metadata
• 认证: 需要RapidAPI认证头。
• 请求方式:
  • JSON Body: 通过video_url提供视频URL。
  • 表单数据: 通过video字段上传视频文件。
• 响应: 返回JSON，包含duration_seconds、width、height、format、codec、frame_rate、bitrate、size_bytes、has_audio、audio_codec。

技术规格

• 认证头: X-RapidAPI-Key（您的RapidAPI订阅密钥）和X-RapidAPI-Host（video-thumbnail-api.p.rapidapi.com）。
• 时间戳格式:
  • HH:MM:SS（例如：01:30:45）
  • HH:MM:SS.mmm（例如：00:05:30.500）
  • MM:SS（例如：05:30）
  • 秒（例如：90）
  • 小数秒（例如：90.5）
• 支持的最大视频大小: 100MB。
• 速率限制:
  • Free: 3/分钟
  • Basic: 10/分钟
  • Pro: 30/分钟
  • Business: 60/分钟

错误响应

• 400: video_url is required、invalid timestamp、unsupported output format、failed to fetch video、video exceeds maximum size limit。
• 401: unauthorized。
• 500: failed to extract thumbnail。
• 错误格式: {"error": "error message here"}。

最佳实践

1. 省略时间戳以快速预览：自动生成前10秒内的随机时间戳。
2. 需要精确帧时指定时间戳。
3. 提取前先获取元数据以了解时长。
4. 选择合适的格式：JPEG适用于大多数情况，PNG用于高质量。
5. 明智调整尺寸：仅请求所需尺寸。
6. 缓存结果：存储缩略图以避免重复提取。

代码示例

• JavaScript (Node.js): 使用axios发送POST请求提取缩略图。
• Python: 使用requests库发送POST请求提取缩略图。
• cURL: 命令行提取缩略图和获取元数据。
• PHP: 使用cURL发送POST请求提取缩略图。