FFHub SDK 示例

FFHub 是 REST API。下面是常见语言的示例。

Node.js / JavaScript

const response = await fetch('https://api.ffhub.io/v1/tasks', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    command: 'ffmpeg -i input.mp4 -c:v libx264 -crf 28 output.mp4'
  })
});
const { task_id } = await response.json();

// 轮询状态
const checkStatus = async (taskId) => {
  const res = await fetch(`https://api.ffhub.io/v1/tasks/${taskId}`, {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  });
  return res.json();
};

Python

import requests

response = requests.post(
    'https://api.ffhub.io/v1/tasks',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    json={'command': 'ffmpeg -i input.mp4 -c:v libx264 -crf 28 output.mp4'}
)
task_id = response.json()['task_id']

# 轮询状态
def check_status(task_id):
    res = requests.get(
        f'https://api.ffhub.io/v1/tasks/{task_id}',
        headers={'Authorization': 'Bearer YOUR_API_KEY'}
    )
    return res.json()

cURL

curl -X POST https://api.ffhub.io/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"command": "ffmpeg -i input.mp4 -c:v libx264 output.mp4"}'

查询状态：

curl https://api.ffhub.io/v1/tasks/TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

Webhook 回调

不想轮询，可以传一个 webhook URL，任务完成后会收到通知：

const response = await fetch('https://api.ffhub.io/v1/tasks', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    command: 'ffmpeg -i input.mp4 -c:v libx264 -crf 28 output.mp4',
    webhook: 'https://your-server.com/api/ffhub-callback'
  })
});

任务完成后，FFHub 会 POST 到你的 webhook，body 是任务结果：

{
  "event_id": "task_abc123",
  "type": "task.succeeded",
  "created_at": "2026-09-17T12:00:00Z",
  "data": {
    "task_id": "task_abc123",
    "status": "succeeded",
    "progress": 100,
    "outputs": [
      {
        "filename": "output.mp4",
        "url": "https://storage.ffhub.io/outputs/task_abc123/output.mp4",
        "size": 10485760
      }
    ],
    "error": "",
    "created_at": "2026-09-17T11:59:00Z",
    "finished_at": "2026-09-17T12:00:00Z"
  }
}

任务失败时结构相同，type 为 task.failed，原因在 data.error。

上传本地文件

源文件不在公网时，先传到 FFHub Storage：申请签名、PUT 上传，再把返回的公开 URL 用到 FFmpeg 命令里。文件直传存储，不经过我们的 API。

Step 1：申请签名 URL

const signRes = await fetch('https://api.ffhub.io/v1/uploads/sign', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    filename: 'input.mp4',
    size: file.size,
    content_type: 'video/mp4'
  })
});
const { upload_url, public_url } = await signRes.json();

Step 2：直接 PUT 到存储

const putRes = await fetch(upload_url, {
  method: 'PUT',
  headers: { 'Content-Type': 'video/mp4' },
  body: file
});
if (!putRes.ok) throw new Error(`Upload failed: ${putRes.status}`);

Content-Type 必须和签名时的 content_type 一致，否则存储会拒绝签名。签名 URL 有效期 15 分钟。

Step 3：在命令里用公开 URL

const taskRes = await fetch('https://api.ffhub.io/v1/tasks', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    command: `ffmpeg -i ${public_url} -c:v libx264 -crf 28 output.mp4`
  })
});