跳转到主要内容

​
FFmpeg 转码 API

FFmpeg API 允许你提交视频和音频转码任务，在云端使用 FFmpeg 进行处理。

​
功能特点

  • 异步处理: 提交任务后轮询获取结果
  • 完整 FFmpeg 支持: 使用任意 FFmpeg 命令
  • 多输出文件: 单个输入生成多个输出文件
  • 进度追踪: 实时监控任务进度
  • Webhook 通知: 任务完成时收到回调通知
  • 元数据提取: 可选获取输出文件的 ffprobe 元信息

​
认证方式

所有 API 请求需要 Bearer Token 认证： 
Authorization: Bearer YOUR_API_KEY
你可以在 FFHub 控制台 获取 API Key。

​
基础 URL

https://api.ffhub.io/v1

​
快速示例

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/video.mp4 -c:v libx264 -crf 23 output.mp4"
  }'

​
任务生命周期

1

创建任务

通过 POST /tasks 提交转码任务和 FFmpeg 命令
2

任务排队

任务进入 pending 状态，等待处理
3

处理中

任务进入 running 状态，可获取进度更新
4

完成

任务以 completed 或 failed 状态结束，输出文件可用

​
任务状态

状态描述
pending任务已排队，等待处理
running任务正在处理中
completed任务成功完成，输出文件可用
failed任务失败，查看 error 字段了解详情

​
下一步

创建任务

了解如何创建转码任务

查询任务

检查任务状态和获取结果

任务列表

查询任务历史记录

服务器状态

检查服务器健康状态和统计信息