介绍

什么是 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 积分

按实际处理时间计费,精确到秒。

技术支持

更多资源

更多详细的 API 文档,请参考 API 文档