介绍
什么是 FFHub?
FFHub 是一个云端 FFmpeg API 服务,让你通过简单的 REST API 调用来运行 FFmpeg 命令。无需配置服务器,无需安装依赖 - 发送命令,即刻获取结果。
快速开始
1. 获取 API Key
在 ffhub.io 注册账号,并在控制台创建 API Key。
2. 创建任务
curl -X POST https://api.ffhub.io/v1/tasks \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"command": "ffmpeg -i https://example.com/input.mp4 -c:v libx264 -preset fast output.mp4"
}'返回:
{
"task_id": "task_abc123",
"status": "pending",
"created_at": "2024-01-01T00:00:00Z"
}3. 查询任务状态
curl https://api.ffhub.io/v1/tasks/task_abc123 \
-H "Authorization: Bearer YOUR_API_KEY"返回:
{
"task_id": "task_abc123",
"status": "completed",
"created_at": "2024-01-01T00:00:00Z",
"finished_at": "2024-01-01T00:03:35Z",
"elapsed": "215.30",
"total_elapsed": "220.50",
"progress": 100,
"outputs": [
{
"filename": "output.mp4",
"url": "https://storage.ffhub.io/outputs/task_abc123/output.mp4",
"size": 10485760
}
]
}API 参考
基础 URL
https://api.ffhub.io/v1认证
所有 API 请求需要在 Authorization 头中携带 Bearer Token:
Authorization: Bearer YOUR_API_KEY接口列表
| 方法 | 接口 | 描述 |
|---|---|---|
| POST | /tasks | 创建新的 FFmpeg 任务 |
| GET | /tasks/:id | 获取任务状态和结果 |
任务状态
| 状态 | 描述 |
|---|---|
| pending | 任务已加入队列,等待处理 |
| running | 任务正在处理中 |
| completed | 任务处理完成 |
| failed | 任务处理失败 |
计费说明
- 1 积分 = 5 秒处理时长
- 1 美元 = 1,000 积分
按实际处理时间计费,精确到秒。
技术支持
- GitHub:ffhub-io/ffmpeg-cookbook(问题反馈 & 讨论)
- 邮箱:[email protected]
- Twitter:@ffhub_io
更多资源
更多详细的 API 文档,请参考 API 文档。