Media Duration API
收藏Media Duration API 数据集概述
基本信息
- API名称: Media Duration API
- 提供者: Snapy AI
- 类别: Video, Images
- 访问地址: https://rapidapi.com/snapy-ai-snapy-ai-default/api/media-duration-api
功能描述
该API是一个功能强大且易于集成的解决方案，允许开发者检索音频和视频文件的总播放时间（时长）。它通过快速可靠的方式返回准确的时长元数据，适用于构建媒体平台、自动化内容分析或验证上传内容。用户上传文件或提供URL，API即可以秒、毫秒或人类可读格式返回总时长。
主要特性
- 快速分析: 在几秒内获取媒体时长
- 详细元数据: 提供时长、格式、文件大小信息
- 多格式支持: 支持MP4、MOV、WebM、MP3、WAV等多种格式
- 批量处理: 可同时分析多个文件
- URL支持: 适用于任何可公开访问的媒体URL
- 高精度: 精确到毫秒的时长检测
- 响应迅速: 平均响应时间在3秒以内
API端点
| 方法 | 端点 | 描述 |
|---|---|---|
| GET | /file-duration |
获取单个媒体文件的时长 |
| POST | /multiple-file-duration |
批量获取多个媒体文件的时长 |
请求与响应格式
单文件分析 (GET /file-duration)
查询参数:
url(string, 必需): 要分析的媒体文件URL
响应示例: json { "success": true, "data": { "duration_seconds": 125.971063, "duration_minutes": 2.10, "duration_formatted": "2:06", "file_url": "https://example.com/sample-video.mp4", "message": "Duration retrieved successfully" } }
批量文件分析 (POST /multiple-file-duration)
请求体: json { "file_urls": [ "https://example.com/video1.mp4", "https://example.com/audio1.mp3" ] }
响应示例: json { "success": true, "data": { "files": [ { "file_url": "https://example.com/video1.mp4", "duration_seconds": 180.971063, "duration_minutes": 3.02, "duration_formatted": "3:01", "status": "success" } ], "summary": { "total_files": 3, "successful": 2, "failed": 1, "total_duration_seconds": 421.796063, "total_duration_minutes": 7.03, "total_duration_formatted": "7:02" } }, "message": "Processed 3 files" }
支持的媒体格式
视频格式
- MP4、MOV、WebM、AVI、MKV、FLV、M4V
音频格式
- MP3、WAV、AAC、FLAC、OGG、M4A、WMA
性能与限制
文件大小限制
| 文件类型 | 最大尺寸 | 处理时间 |
|---|---|---|
| 视频 | 2GB | 3-10秒 |
| 音频 | 500MB | 1-5秒 |
批量处理限制
| 批量类型 | 最大文件数 | 处理时间 |
|---|---|---|
| 单次请求 | 50个文件 | 10-30秒 |
| 混合格式 | 25个文件 | 15-45秒 |
处理速度
- 平均响应时间: 2-5秒/文件
- 并发处理: 最多同时处理10个文件
- 准确率: 标准格式99.9%
集成示例
提供JavaScript、Python和PHP的完整集成代码示例，包括单文件分析和批量处理功能。
错误处理
常见错误包括：
- URL不可访问
- 无效的媒体URL
- 不支持的格式
- 文件过大（超过2GB）
- 超出速率限制
使用场景
- 内容管理系统中的媒体文件分析
- 视频平台集成和播放列表时长计算
- 播客管理和元数据提取
- 媒体文件验证和处理前检查
最佳实践建议
- 确保媒体URL可公开访问
- 使用标准格式以获得最快处理速度
- 将文件大小保持在推荐限制内
- 对多个文件使用批量处理
- 实施适当的错误处理和重试逻辑
