ƒƒffhub.io

SDK・コード例 - FFHub

FFHub API を各種言語で利用するコード例（Node.js、Python、cURL、Webhook）。

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();

// Poll for completion
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']

# Poll for completion
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 は指定の webhook URL に POST リクエストでタスク結果を送信します:

{
  "task_id": "task_abc123",
  "status": "completed",
  "outputs": [
    {
      "filename": "output.mp4",
      "url": "https://storage.ffhub.io/outputs/task_abc123/output.mp4",
      "size": 10485760
    }
  ]
}

ファイルアップロードの流れ

入力がローカルファイル（公開 URL でない）の場合、先にアップロードして得られた URL を FFmpeg コマンドで使います。

Step 1: ファイルをアップロード

const formData = new FormData();
formData.append('file', fileBlob, 'input.mp4');

const uploadRes = await fetch('https://api.ffhub.io/v1/files', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
  body: formData
});
const { url } = await uploadRes.json();

Step 2: URL を FFmpeg コマンドで使用

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 ${url} -c:v libx264 -crf 28 output.mp4`
  })
});
SDK・コード例 - FFHub — FFHub Docs