跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.ffhub.io/llms.txt

Use this file to discover all available pages before exploring further.

​
概览

ffhub 是一个命令行工具，让你像在本地运行 FFmpeg 一样使用云端处理。本地文件会自动上传后处理。

​
安装

npm install -g ffhub

​
配置

在 ffhub.io 获取 API Key 后配置： 
ffhub config YOUR_API_KEY
或通过环境变量设置： 
export FFHUB_API_KEY=YOUR_API_KEY

​
使用

像使用 FFmpeg 一样，在命令前加上 ffhub： 
ffhub -i https://example.com/video.mp4 -c:v libx264 output.mp4
-i 后面的本地文件会被自动检测并上传到云存储。

​
命令列表

命令说明
ffhub [ffmpeg 参数]在云端运行 FFmpeg 命令
ffhub whoami查看当前用户和积分
ffhub list查看最近的任务
ffhub status <task_id>查看任务状态
ffhub config <api_key>保存 API Key
ffhub help显示帮助

​
查看任务列表

ffhub list                  # 显示最近 10 条任务
ffhub list --limit=20       # 显示最近 20 条
ffhub list --status=failed  # 按状态筛选

​
查看账户信息

ffhub whoami

  Email:    you@example.com
  User ID:  b4e6a3c3-...
  Credits:  15000

​
工作原理

  1. 运行 ffhub -i local.mp4 -c:v libx264 output.mp4
  2. CLI 检测到 local.mp4 是本地文件，自动上传
  3. FFmpeg 命令发送到 FFHub 云端处理
  4. CLI 轮询进度并实时显示状态
  5. 完成后显示输出文件下载链接

​
下一步

FFmpeg API 文档

直接使用 REST API 进行编程访问

获取 API Key

注册并获取 API Key