Samtrmr

Trim your favourite video

原始信息汇总

Samtrmr — 视频裁剪 API 数据集总结

数据集概述

Samtrmr 是一个视频裁剪 API，允许用户将任意视频精确裁剪为指定片段，并获取可下载的 MP4 链接。用户提交作业后，系统异步处理，通过轮询状态获取结果。

工作流程

1. 提交裁剪任务 — 通过 POST /trim 接口提交 YouTube URL 及起止时间（秒）
2. 获取 job_id — 任务异步处理
3. 轮询状态 — 通过 GET /status/{job_id} 查询任务状态直至 completed
4. 下载结果 — 从 video_url 获取裁剪后的视频

API 端点

方法	端点	描述
POST	/trim	提交视频裁剪任务，请求体包含 {"url": "...", "start": 30, "end": 45}
GET	/status/{job_id}	查询裁剪任务当前状态
GET	/health	健康检查

身份认证

所有请求需通过 RapidAPI 密钥进行认证，在请求头 X-RapidAPI-Key 中传递。缺失或无效密钥将返回 403 响应。

任务生命周期

状态	含义
pending	任务已接受，等待处理
processing	视频正在下载和裁剪
completed	裁剪视频已就绪，可从 video_url 获取
failed	处理失败，需查看 error 字段

订阅方案与定价

方案	价格	配额
Basic	免费	5 次请求/天
Pro	$2.99/月	50 次请求/天

错误码说明

代码	含义
400	无效 JSON 或缺少 url、start、end 字段
403	缺失或无效的 API 密钥
404	任务不存在（可能已过期）

注意事项

• 超过 10 分钟的视频会被拒绝，任务将报 Video is longer than 10 minutes 错误
• 任务记录保存 7 天，video_url 链接有效期为 7 天
• start 和 end 参数以秒为单位